Converts a time-date value to a text string, incorporating time zone information.

Syntax

@TimeToTextInZone( timeDate ; timeZone ; formatString )

Parameters

timeDate

Time-date value or time-date list. The time-date value or values to be converted.

Canonical time zone value. You can derive a time zone value using a Lotus Notes Time zone field.

Optional. String consisting of one or more of the following format specifiers:

Format specifier	Definition
D0	Year, month, and day
D1	Month and day, year if it is not the current year
D2	Month and day
D3	Month and year
T0	Hour, minute, and second
T1	Hour and minute
S0	Date only
S1	Time only
S2	Date and time
S3	Date, time, Today, or Yesterday
Sx	Use when you cannot predict the exact format of the value being passed, but you know that it is either a time, a date, or both.

You can include up to three specifiers, but only one that begins with D, one that begins with T, and one that begins with S.

string

The time-date value converted to a string.

If the first parameter is a list, the function operates on each list element, and the return value is a list with the same number of elements.

Example
See Also

Converting data types
Time-date constants

Glossary