SetDate()

Sets the system date

Syntax

      SetDate( <dDate>, [<lMode>] ) --> lSet

Arguments

<dDate> Designates which date to use to set the system date.

<lMode> Designates whether the date should also be set in the CMOS- RAM of an AT. The default is do not write (.F.). Note that in Windows plataform this adjust is automatic, therefore this parameter is without efect.

Returns

SetDate() RETURNs .T. when the date is successfully set.

Description

When you use this FUNCTION to set the system date from within your xHarbour application, all files acquire this date with each write procedure.

Examples

      Set the system date in each case; but the hardware clock only
      on an AT:

      dNewDate := SToD( "19910730" )
      IF ISAT()
         SetDate( dNewDate, .T. )
      ELSE
         SetDate( dNewDate )
      ENDIF

      Or, more compactly:

      SetDate( dNewDate, ISAT() )

Compliance

This function is CA-Cl*pper Tools compatible.

Platforms

Windows, Linux

Files

Source is dattime3.c, library is libct.

Seealso

SETTIME()