VA FileMan Programmer Manual: DD^%DT

Contents:

Main

Classic VA FileMan API

DD^%DT: Converts Internal to External Date Format

Introduction to Date/Time Formats (Read First)

Reference Type	Category	ICR #
Supported	Classic VA FileMan	10003

Description

There are two ways to convert a date from internal to external format:

DD^%DT (this call)
X ^DD("DD")

This is the reverse of what %DT does. The DD^%DT API takes a VA FileMan internal date in the Y variable and converts it to its external representation.

Input Variables

Y	(Required) This contains the internal date to be converted. If this has five or six decimal places, seconds are automatically returned.
%DT	(Optional) This forces seconds to be returned even if Y does not have that resolution. %DT must contain S for this to happen.

Output Variable

Y	Y is returned as the external form of the date.

REF: See also the DT^DIO2: Writes External Date from Internal API, which takes an internal date in the Y variable and writes out its external form.

Example

Figure 79: DD^%DT API—Example: Input and Output

>S Y=2690720.163 D DD^%DT W Y
JUL 20, 1969@1630

This results in Y being equal to JUL 20, 1969@16:30. (Single space before the 4-digit year.)

Reviewed/Updated: June 2026