DATETIME Function

Returns the date and time value represented by datetime or expression.

Syntax

DATETIME("datetime"|expression[,lcid])

Parameters

Name	Required/Optional	Data Type	Description
datetime	Required	String	Any string commonly recognized as a date and time or a reference to a cell containing a date and time.
expression	Required	String	Any expression that yields a date and time.
lcid	Optional	Number	Specifies the locale identifier to be used in evaluating a non-local datetime. The locale identifier is a number described in the system header files.

Return Value

Datetime

Remarks

If datetime is missing or cannot be interpreted as a valid date or time, DATETIME returns a #VALUE! error.

The returned value is formatted according to the short date style and time style in the system's current Regional Settings.

The DATETIME function also accepts a single number value for expression where the integer portion of the result represents the number of days since December 30, 1899, and the decimal portion represents the fraction of a day since midnight.

Example 1

DATETIME("May 30, 1997")+5 ed.

Returns the value representing 6/4/1997.

Example 2

FORMAT(DATETIME("5/20/1997 14:30:45"),"C")

Returns the string "Tuesday, May 20, 1997 2:30:45 PM."

Example 3

DATETIME("1:30 PM July 19")

Returns the value representing 7/19/2001 1:30:00 PM (assuming the current year is 2001).

Example 4

DATETIME(35580.6337)

Returns the value representing 5/30/1997 3:12:32 PM.