Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileGettime()
Tsettime()
Tsetdate()
Settime()                                                             XBIOS

Syntax

VOID Settime( time )
LONG time;

Function      Settime() sets a new IKBD date and time.

Opcode        22 (0x16)

Availability  All TOS versions.

Parameters    time is a LONG bit array defined as follows:

               Bits   Meaning

                0-4   Seconds / 2 (0-29)

               5-10   Minute (0-59)

              11-15   Hour (0-23)

              16-20   Day (1-31)

              21-24   Month (1-12)

              25-31   Year - 1980 (0-127)

              The value can be represented in a C structure as follows:

              typedef struct
              {
               unsigned year:7;
               unsigned month:4;
               unsigned day:5;
               unsigned hour:5;
               unsigned minute:6;
               unsigned second:5;
              } BIOS_TIME;

Binding       move.l   time,-(sp)
              move.w   #$16,-(sp)
              trap     #14
              addq.l   #6,sp

Comments      As of TOS 1.02, this function also updates the GEMDOS time.

See Also      Gettime(), Tsettime(), Tsetdate()