Admin at 20:20, 13 December 2014

2014-12-13T20:20:07Z

Admin: Created page with "= Action = Returns a number, which represents the System Day
2013-02-12T17:50:11Z

Created page with "= Action = Returns a number, which represents the System Day Action =

Returns a number, which represents the System Day

 

 

= Syntax =

Target = SysDay()

Target = SysDay(bDayMonthYear)

Target = SysDay(strDate)

Target = SysDay(lSysSec)

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="609" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 112px; border: 1px solid rgb(0, 0, 0);" |
Target

| valign="top" width="89%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A Variable (LONG), that is assigned with the System-Day

|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 112px; border: 1px solid rgb(0, 0, 0);" |
bDayMonthDay

| valign="top" width="89%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A Byte, which holds the Day-value followed by Month(Byte) and Year (Byte)

|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 112px; border: 1px solid rgb(0, 0, 0);" |
strDate

| valign="top" width="89%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A String, which holds a Date-String in the format specified in the

CONFIG DATA statement

|- style="vertical-align: top;"
| valign="top" width="19%" style="width: 112px; border: 1px solid rgb(0, 0, 0);" |
lSysSec

| valign="top" width="89%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A variable, which holds a System Second (SysSec)

|}
</div>
 

 

The Function can be used with 4 different kind of inputs:

 
<div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 1.
| Without any parameter. The internal Date-values of SOFTCLOCK (_day, _month, _year) are used.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 2.
| With a user defined date array. It must be arranged in same way (Day, Month, Year) as the internal SOFTCLOCK date. The first Byte (Day) is the input by this kind of usage. So the Day of the Year can be calculated of every date.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 3.
| With a Date-String. The date-string must be in the Format specified in the Config Date Statement.
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | 4.
| With a System Second Number (LONG)
|}
</div>
 

 

The Return-Value is in the Range of 0 to 36524. 2000-01-01 starts with 0.

The Function is valid in the 21th century (from 2000-01-01 to 2099-12-31).

 

 

= See also =

[[DATETIME|Date and Time Routines]] , [[CONFIG DATE|Config Date]] , [[CONFIG CLOCK|Config Clock]] , [[SYSSEC|SysSec]]

 

 

= Example =

 <source lang="bascomavr">
Enable Interrupts
Config Clock = Soft
Config Date = YMD , Separator =.' ANSI-Format

Dim Strdate As String * 8
Dim Bday Asbyte , Bmonth As Byte , Byear As Byte
Dim Wsysday As Word
Dim Lsyssec As Long

' Example 1 with internal RTC-Clock
_day = 20 : _Month = 11 : _Year = 2 ' Load RTC-Clock for example - testing
Wsysday = Sysday()
Print "System Day of " ; Date$ ; " is " ; Wsysday

' System Day of 02.11.20 is 1054

' Example 2 with defined Clock - Bytes (Day / Month / Year)
Bday = 24 : Bmonth = 5 : Byear = 8
Wsysday = Sysday(bday)
Print "System Day of Day=" ; Bday ; " Month=" ; Bmonth ; " Year=" ; Byear ; " is " ; Wsysday
' System Day of Day=24 Month=5 Year=8 is 3066

' Example 3 with Date - String
Strdate = "04.10.29"
Wsysday = Sysday(strdate)
Print "System Day of " ; Strdate ; " is " ; Wsysday
' System Day of 04.10.29 is 1763

' Example 4 with System Second
Lsyssec = 123456789
Wsysday = Sysday(lsyssec)
Print "System Day of System Second " ; Lsyssec ; " is " ; Wsysday
' System Day of System Second 123456789 is 1428"Now it's " ; Lsystemsecondselapsed ; " seconds later"
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

@@ Line 29: / Line 29: @@
 | valign="top" width="89%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
-A Variable (LONG), that is assigned with the System-Day
+A Variable (WORD), that is assigned with the System-Day
 |- style="vertical-align: top;"