SetTime()

SetTime()

Sets the system clock

Syntax

      SetTime( <cTime>, [<lMode>] ) --> lSet

Arguments

<cTime> Designates a character string that contains the time that is to become the system time.

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

Returns

The FUNCTION RETURNs .T. when the time is set successfully.

Description

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

Examples

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

      cNewTime := "10:20:00"
      IF ISAT()
         SetTime( cNewTime, .T. )
      ELSE
         SetTime( cNewTime )
      ENDIF

      Or, more compactly:

      SetTime( cNewTime, ISAT() )

Compliance

This function is CA-Cl*pper Tools compatible.

Platforms

Windows, Linux

Files

Source is dattime3.c, library is libct.

Seealso

SETDATE(), TIMEVALID()

Harbour All Functions – S

SaveToken

SayScreen

Seconds
Secs

Select

Set

SetAtLike

SetDate

SetKey

SetMode

SetPrec

SetTime

SetTypeahead

Sign

Sin

SinH

Space

Sqrt

Str

StrDiff

StrFormat

StrSwap
StrTran
StrZero
SubStr

CT_SetDate

  NAME
     SetDate()
  CATEGORY
     CT Date and Time Functions
  ONELINER
     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
     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 := hb_SToD( "19910730" )
     IF IsAt()
        SetDate( dNewDate, .T. )
     ELSE
        SetDate( dNewDate )
     ENDIF
     Or, more compactly:
     SetDate( dNewDate, IsAt() )
  STATUS
     Ready
  COMPLIANCE
     This function is Clipper Tools compatible.
  PLATFORMS
     Windows, Linux
  FILES
     Library is hbct.
  SEEALSO
     SetTime()

Tools — Date/Time Functions

Introduction Date/Time Functions
ADDMONTH()   Adds or subtracts months to/from a date
BOM()        Determines the date of the first day of a month
BOQ()        Determines the date for the beginning of a quarter
BOY()        Determines the date for the beginning of a year
CTODOW()     Converts the day of the week name into a corresponding number
CTOMONTH()   Converts the name of the month into a corresponding number
DMY()        Returns a date in "DD Month YY" format
DOY()        Determines the day of the year for a specific date
EOM()        Determines the date for the last day of a month
EOQ()        Determines the date for the end of a quarter
EOY()        Determines the date for the end of the year
ISLEAP()     Tests if a specific year is a leap year
LASTDAYOM()  Determines the number of days in a month
MDY()        Returns a date in the "Month DD, YY" format
NTOCDOW()    Changes the number of a weekday into a weekday name
NTOCMONTH()  Changes the number of a month into a month name
QUARTER()    Determines the quarter in which a specific date lies
SECTOTIME()  Converts seconds into a time string
SETDATE()    Sets the system date
SETTIME()    Sets the system clock
SHOWTIME()   Continuously displays the time at desired screen position
STOD()       Converts an ANSI date string into Clipper format
TIMETOSEC()  Calculates the seconds since midnight
TIMEVALID()  Determines whether a specified time is valid
WAITPERIOD() Pauses a specified time in increments of 1/100 seconds
WEEK()       Returns the calendar week for a date
WOM()        Returns the week within a month.