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 – T

TabExpand
TabPack

Tan

TanH

TBrowseDB

TBrowseNew

TFileRead

THtml

Time

TimeValid

TNortonGuide 

Token
TokenAt
TokenEnd
TokenExit
TokenInit
TokenLower
TokenNext
TokenNum
TokenSep
TokenUpper

Tone

TOs2

Transform
Trim

TRtf

TTroff

 Type

Date & Time Functions

Date & Time Functions

ADays Returns an array with the days names
AddMonth Adds or subtracts months to/from a date
AMonths Returns an array with the months names
BOM Beginning date Of Month of given date
BOQ Date of beginning Of quarter containing given date
BOY Date to find first day of year, default is DATE()
CDoW Converts a date to the day of week
CMonth Return the name of the month
CToD Converts a character string to a date expression
CToDoW Convert name of day of the week to its ordinal number
CToMonth Convert name of month to its ordinal number
Date Return the Current OS Date
Day Return the numeric day of the month
Days Convert elapsed seconds into days
DaysInMonth Returns the number of days in month
DaysToMonth Total number of days from first of Jan to beginning of nMonth
DMY Returns the date as a string in DD Month YY format
DoW Value for the day of week
DOY Determines the day of the year for a specific date
DToC Date to character conversion
DToS Date to string conversion
ElapTime Calculates elapted time
EOM End Of Month
EOQ Date of end of quarter
EOY Last date Of Year
IsLeap Tests if a specific year is a leap year
IsLeapYear Checks if the given date is a leap year
LastDayOM Determines the number of days in a month
MDY Returns the date as a string in Month DD, YY or Month DD, YYYY
Month Converts a date expression to a month value
NToCDoW Find day name by num of day
NToCMonth Find a month name by the number of month
Quarter Returns a number equal to the quarter in which a date falls
Seconds Returns the number of elapsed seconds past midnight
Secs Return the number of seconds from the system date
SecToTime Converts seconds into a time string
Time Returns the system time as a string
TimeValid Determines whether a specified time is valid
TimeToSec Calculates the seconds since midnight
WaitPeriod Pauses a specified time in increments of 1/100 seconds
Week Returns the calendar week a number
WOY Gets the week number of the year
Year Converts the year portion of a date into a numeric value

CT_TimeValid

  NAME
     TimeValid()
  CATEGORY
     HBCT Date and Time Functions
  ONELINER
     Determines whether a specIFied time is valid
  SYNTAX
     TimeValid( <cTime> ) --> lValid
  ARGUMENTS
     <cTime>  Designates a character string that contains the time to
     test.
  RETURNS
     TimeValid() RETURNs .T. when <cTime> is a valid time; or .F. when
     <cTime> is an invalid time.
  DESCRIPTION
     With input that requires time manipulation, writing your own UDF to
     check time inputs was unavoidable up to now.  TimeValid() permits
     Complete checking of a time designation.  You can use this FUNCTION
     effectively with a VALID clause within a READ mask.
 Note
     Note the format for time designations.  There must always be
     two digits for hours, minutes, seconds, and hundredths; otherwise,
     the time it is regarded as invalid.  Valid examples are "12",
     "12:59", "12:59:59", and "12:59:59:99".  By contrast, invalid
     examples are "24", "12:60", or "12:1", and/or "12:".  IF you work
     with time strings that are not completely filled and that you need to
     check with TimeValid(), then they must be TRIMmed prior to the use of
     TimeValid() (see following Examples).
  EXAMPLES
       PROC MAIN()
          SETMODE( 25, 80 )
          CLS
          cBegin := TIME()
          cEnd  := SECTOTIME( SECONDS() + 60 )
          // Using the VALID clause with TRIM, all valid times are
          // accepted, even IF no seconds or minutes are specified:
          @ 5, 10 SAY "Please input time for beginning work:";
             GET cBegin VALID TimeValid( RTrim( cBegin ) )
          // Using a VALID clause without TRIM, hours and minutes must be
          // specified, so that TimeValid() can confirm a valid time:
          @ 7, 10 SAY "Please input time for beginning work:";
             GET cEnd VALID TimeValid( cEnd )
          READ
       RETURN // MAIN
  STATUS
     Ready
  COMPLIANCE
     This function is Clipper Tools compatible.
  PLATFORMS
     All
  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.