Admin: 1 revision

2013-02-15T19:15:51Z

1 revision

Admin: Created page with "= Action = Returns the Seconds of a Day.
2013-02-11T22:50:37Z

Created page with "= Action = Returns the Seconds of a Day. <spa..."

New page
== (COPIED FROM ENGLISH PAGE) === Action =

Returns the Seconds of a Day.

 

 

 

= Syntax =

Target = SECOFDAY()

Target = SECOFDAY(bSecMinHour)

Target = SECOFDAY(strTime)

Target = SECOFDAY(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="100%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A variable (LONG), that is assigned with the Seconds of the Day

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

| valign="top" width="100%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A Byte, which holds the Second-value followed by Minute(Byte) and Hour(Byte)

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

| valign="top" width="100%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A String, which holds the time in the format „hh:mm:ss"

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

| valign="top" width="100%" style="width: 488px; border: 1px solid rgb(0, 0, 0);" |
A Variable (Long) which holds the System Second

|}
</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 Time of SOFTCLOCK (_sec, _min, _hour) is 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 time array. It must be arranged in same way (Second, Minute, Hour) as the internal SOFTCLOCK time. The first Byte (Second) is the input by this kind of usage. So the Second of Day can be calculated of every time.
|}
</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 time-String. The time-string must be in the Format „hh:mm:ss".
|}
</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 86399 from 00:00:00 to 23:59:59.

No validity-check of input is made.

 

 

= See also =

[[DATETIME|Date and Time Routines]] , [[SYSSEC|SysSec]]

 

 

= Partial Example =

 <source lang="bascomavr">
' ================= Second of Day =============================================
' Example 1 with internal RTC-Clock
_sec = 12 : _min = 30 : _hour = 18 ' Load RTC-Clock for example - testing

Lsecofday = Secofday()
Print "Second of Day of " ; Time$ ; " is " ; Lsecofday

' Example 2 with defined Clock - Bytes (Second / Minute / Hour)
Bsec = 20 : Bmin = 1 : Bhour = 7
Lsecofday = Secofday(bsec)
Print "Second of Day of Sec=" ; Bsec ; " Min=" ; Bmin ; " Hour=" ; Bhour ; " (" ; Time(bsec) ; ") is " ; Lsecofday

' Example 3 with System Second
Lsyssec = 1234456789
Lsecofday = Secofday(lsyssec)
Print "Second of Day of System Second " ; Lsyssec ; "(" ; Time(lsyssec) ; ") is " ; Lsecofday

' Example 4 with Time - String
Strtime = "04:58:37"
Lsecofday = Secofday(strtime)
Print "Second of Day of " ; Strtime ; " is " ; Lsecofday
</source> {{Languages}}

[[Category:BASCOM Language Reference/de]]