DateTimeToReal (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Standard functions / Date and time management functions

Calculation mode
Valid dates/times

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DateTimeToReal (Function)

In french: DateHeureVersRéel

Converts a date and a time to an 8-byte real. This real corresponds to:

the number of elapsed days since January 1, 1900 (compatible with Excel, starts with 1).
the number of elapsed days since January 1, 1904 (compatible with Excel by checking the option "Use 1904 date system", starts with 0).

Remark: The option "Use 1904 date system" can be configured in the advanced options of Microsoft Excel. In Open Office, this option is available in the options of Open Office Calc ("Calculate" section, "Date" option).

New in version 28

This function is now available for WEBDEV sites in PHP.

Example

// Displays "3.25"
Info(DateTimeToReal("190001030600"))

MyDay is DateTime
MyDay = "190001030600"
// Displays "3.25"
Info(DateTimeToReal(MyDay))

Syntax

<Result> = DateTimeToReal(<DateTime to convert> [, <From 1904>])

<Result>: Real

Number of days that correspond to the DateTime variable passed as parameter.
-1 if an error occurred (invalid date and time).

<DateTime to convert>: DateTime variable or character string

Value of the date and time to convert. This parameter can be:
a DateTime variable.
a character string in one of the following formats:
YYYYMMDDHHmmSSCCC
YYYYMMDDHHmmSSCC
YYYYMMDDHHmmSS
YYYYMMDDHHmm
YYYYMMDDHH
YYYYMMDD

<From 1904>: Optional boolean

Calculation mode:
True if the date is calculated from 1904.
False (default value) if the date is calculated from 1900.

Remarks

Calculation mode

The integer part of the result gives the serial number that corresponds to the date in the parameter:

the count starts with 1 for 01/01/1900.
the count starts with 0 for 01/01/1904 if <From 1904> is set to True.

The decimal part gives the fraction of a day that corresponds to the time in the parameter (for example, 06:00 corresponds to 0.25).

Any type conversion may cause a loss of precision.

Valid dates/times

<DateTime to convert> is considered invalid:

if the date is invalid or earlier than the starting date. The date must be between 01/01/1900 and 12/31/999 or 01/01/1904 and 12/31/999. You can check the validity of a date using DateValid.
if the time is invalid. You can check the validity of a time using TimeValid.

Component: wd280std.dll