DAYOFYEAR - Revision history

Admin: Created page with "= Action = Returns the Day of the Year of a Date
2013-02-08T13:52:23Z

Created page with "= <span class="f_Header">Action</span> = Returns the Day of the Year of a Date <span style="font-family: Arial;"> </span> <span style="font-family: Arial;"> </spa..."

New page
= <span class="f_Header">Action</span> =

Returns the Day of the Year of a Date

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Syntax</span> =

Target = <span class="f_Syntax">DayOfYear</span>()

Target = <span class="f_Syntax">DayOfYear</span>(bDayMonthYear)

Target = <span class="f_Syntax">DayOfYear</span>(strDate)

Target = <span class="f_Syntax">DayOfYear</span>(wSysDay)

Target = <span class="f_Syntax">DayOfYear</span>(lSysSec)

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Remarks</span> =
<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="22%" style="width: 130px; border: 1px solid rgb(0, 0, 0);" |
Target

| valign="top" width="100%" style="width: 470px; border: 1px solid rgb(0, 0, 0);" |
A Integer, that is assigned with the Day of the Year

|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 130px; border: 1px solid rgb(0, 0, 0);" |
BDayMonthYear

| valign="top" width="100%" style="width: 470px; 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="22%" style="width: 130px; border: 1px solid rgb(0, 0, 0);" |
StrDate

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

CONFIG DATE statement

|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 130px; border: 1px solid rgb(0, 0, 0);" |
WSysDay

| valign="top" width="100%" style="width: 470px; border: 1px solid rgb(0, 0, 0);" |
A Variable (Word) which holds a System Day (SysDay)

|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 130px; border: 1px solid rgb(0, 0, 0);" |
LsysSec

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

|}
</div>
<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

The Function can be used with five different kind of Input:

<span style="font-family: Arial;"> </span>
<div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | <span style="font-size: 10pt;">1.</span>
| 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" | <span style="font-size: 10pt;">2.</span>
| 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" | <span style="font-size: 10pt;">3.</span>
| 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" | <span style="font-size: 10pt;">4.</span>
| With a System Day Number (WORD)
|}
</div><div style="padding: 0px; margin: 0px 0px 0px 35px;">
{| border="0" cellpadding="0" cellspacing="0"
|- valign="baseline" style="vertical-align: baseline;"
| width="15" | <span style="font-size: 10pt;">5.</span>
| With a System Second Number (LONG)
|}
</div>
<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

The Return-Value is in the Range of 0 to 364 (365 in a leap year). January the first starts with 0.

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

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">See also</span> =

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

<span style="font-family: Arial;"> </span>

<span style="font-family: Arial;"> </span>

= <span class="f_Header">Example</span> =

See [[DAYOFWEEK|DayOfWeek]]
<div><br/></div><br/>
{{Languages}} [[Category:BASCOM Language Reference]]