pitm_setdst

This sets the tzinfo member of a PITIMESTAMP structure to the passed daylight savings or standard time for the current time zone. This is useful when setting a timestamp that is in the ambiguous hour during the fall change from daylight to standard settings.

Visual Basic format

Declare Sub pitm_setdst Lib "piapi32.dll" (
time0 As PITimeStamp,
ByVal tm_isdst&)

C format

PIVOID PIPROC pitm_setdst(
PITIMESTAMP PIPTR *timestamp,
int32 tm_dst);

Returns

Nothing

Arguments

timestamp (passed,modified)

Structure containing timestamp.

tm_dst (passed)

Flag indicating Daylight (1) or Standard (0) time to be set.

Usage Notes

The PITIMESTAMP tzinfo structure member will contain information uniquely identifying the timestamp and DST settings. The values -1, 0, and 1 used for C run time routines are not valid for the tzinfo structure member.

Only the tzinfo structure member is modified without consideration of the values of the other fields. For example, it is possible to set a time that is unambiguously in standard time to daylight time. However, this is not advisable.

Enabling Operational Intelligence