Su, Xiaomeng 76a5b1ee83 dli_sqlreference_20240227

Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>

2024-03-27 22:02:33 +00:00

9.9 KiB

Raw Permalink Blame History

to_date1

This function is used to convert a string in a specified format to a date value.

Similar function: to_date. The to_date function is used to return the year, month, and day in a time. The date format cannot be specified.

Syntax

to_date1(string date, string format)

Parameters

**Table 1** Parameters
Parameter	Mandatory	Type	Description
date	Yes	STRING	String to be converted The following formats are supported: yyyy-mm-dd yyyy-mm-dd hh:mi:ss yyyy-mm-dd hh:mi:ss.ff3
format	Yes	STRING	Format of the date to be converted Constant of the STRING type. Extended date formats are not supported. The value is a combination of the time unit (year, month, day, hour, minute, and second) and any character. YYYY or yyyy indicates the year. MM indicates the month. mm indicates the minute. dd indicates the day. HH indicates the 24-hour clock. hh indicates the 12-hour clock. mi indicates the minute. ss indicates the second. SSS indicates the millisecond.

Return Values

The return value is of the STRING type.

If the value of date is not of the DATE or STRING type, the error message "data type mismatch" is displayed.
If the value of date is of the DATE or STRING type but is not in one of the supported formats, NULL is returned.
If the value of date is NULL, NULL is returned.
If the value of format is NULL, a date in the yyyy-mm-dd format is returned.

Example Code

The value NULL is returned.

select to_date1('2023-08-16 10:54:36','yyyy-mm-dd');

The value 2023-08-16 00:00:00 is returned.

select to_date1('2023-08-16','yyyy-mm-dd');