mirror of
https://gitlab.com/freepascal.org/fpc/source.git
synced 2025-08-27 15:13:41 +02:00
+ Second batch of descriptions and examples
This commit is contained in:
michael
parent
d27bebb43a
commit
cca310e33d
@ -1193,6 +1193,10 @@ returns a <var>TDateTime</var> value with the date of the last day of that year
|
||||
<seealso>
|
||||
<link id="StartOfAYear"/>
|
||||
<link id="StartOfTheYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="EndOfAYear"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex25"/>
|
||||
@ -1218,6 +1222,10 @@ returns a <var>TDateTime</var> value with the date of the last day of that year
|
||||
<link id="StartOfTheYear"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex26"/>
|
||||
</element>
|
||||
@ -1243,6 +1251,10 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<link id="StartOfTheYear"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex27"/>
|
||||
</element>
|
||||
@ -1260,6 +1272,21 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfTheMonth">
|
||||
<short>Calculate the first day of the month, given a date in that month.</short>
|
||||
<descr>
|
||||
<var>StartOfTheMonth</var> extracts the year and month parts of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date of the first day of that year
|
||||
and month as the <link id="StartOfAMonth"/> function.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex28"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1275,6 +1302,21 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfTheMonth">
|
||||
<short>Calculate a DateTime value representing the last day of the month, given a day in that month.</short>
|
||||
<descr>
|
||||
<var>EndOfTheMonth</var> extracts the year and month parts of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date of the first day of that year
|
||||
and month as the <link id="EndOfAMonth"/> function.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex29"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1290,6 +1332,21 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfAMonth">
|
||||
<short>Return first date of month, given a year/month pair.</short>
|
||||
<descr>
|
||||
<var>StartOfAMonth</var> e
|
||||
returns a <var>TDateTime</var> value with the date of the first day of the
|
||||
month indicated by the <var>AYear</var>, <var>AMonth</var> pair.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex30"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1310,6 +1367,21 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfAMonth">
|
||||
<short>Calculate a datetime value representing the last day of the indicated month</short>
|
||||
<descr>
|
||||
<var>EndOfAMonth</var> e
|
||||
returns a <var>TDateTime</var> value with the date of the last day of the
|
||||
month indicated by the <var>AYear</var>, <var>AMonth</var> pair.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex31"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1330,6 +1402,22 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfTheWeek">
|
||||
<short>Return the first day of the week, given a date.</short>
|
||||
<descr>
|
||||
<var>StartOfTheWeek</var> extracts the year and week parts of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date of the first day of that
|
||||
week as the <link id="StartOfAWeek"/> function.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex32"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1345,6 +1433,22 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfTheWeek">
|
||||
<short>Calculate a DateTime value which represents the end of a week, given a date in that week.</short>
|
||||
<descr>
|
||||
<var>EndOfTheWeek</var> extracts the year and week parts of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date of the last day of that
|
||||
week as the <link id="EndOfAWeek"/> function.
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex33"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1359,7 +1463,29 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfAWeek">
|
||||
<short>Return the first day of the week, given a year and a week in the year.</short>
|
||||
<short>Return a day of the week, given a year, week and day in the week.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>StartOfAWeek</var>
|
||||
returns a <var>TDateTime</var> value with the date of the indicated day of the
|
||||
week indicated by the <var>AYear</var>, <var>AWeek</var>,
|
||||
<var>ADayOfWeek</var> values.
|
||||
</p>
|
||||
<p>
|
||||
The default value for <var>ADayOfWeek</var> is 1.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex34"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1384,7 +1510,28 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfAWeek">
|
||||
<short></short>
|
||||
<short>Return the last moment of day of the week, given a year and a week in the year.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>EndOfAWeek</var> returns a <var>TDateTime</var> value with the date of the
|
||||
last moment (23:59:59:999) on the indicated day of the week indicated by the
|
||||
<var>AYear</var>, <var>AWeek</var>, <var>ADayOfWeek</var> values.
|
||||
</p>
|
||||
<p>
|
||||
The default value for <var>ADayOfWeek</var> is 7.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex35"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1407,29 +1554,32 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<short>Day of the week</short>
|
||||
</element>
|
||||
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfAWeek">
|
||||
<short>Calculate a datetime value which represents the end of a specified week.</short>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
<element name="EndOfAWeek.Result">
|
||||
<short>DateTime value representing the end of the week specified by <var>AYear</var>, <var>AWeekOfYear</var> and <var>DayOfWeek</var></short>
|
||||
</element>
|
||||
|
||||
<!-- argument Visibility: default -->
|
||||
<element name="EndOfAWeek.AYear">
|
||||
<short>Year</short>
|
||||
</element>
|
||||
|
||||
<!-- argument Visibility: default -->
|
||||
<element name="EndOfAWeek.AWeekOfYear">
|
||||
<short>Week of the year</short>
|
||||
</element>
|
||||
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfTheDay">
|
||||
<short>Calculate the start of the day as a DateTime value, given a moment in the day.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>StartOfTheDay</var> extracts the date part of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date/time indication of
|
||||
the start (0:0:0.000) of this day.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfADay"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOftheDay"/>
|
||||
<link id="EndOfADay"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex36"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1445,6 +1595,29 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfTheDay">
|
||||
<short>Calculate a datetime value that represents the end of a given day.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>EndOfTheDay</var> extracts the date part of <var>AValue</var> and
|
||||
returns a <var>TDateTime</var> value with the date/time indication of
|
||||
the last moment (23:59:59.999) of this day.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOftheDay"/>
|
||||
<link id="StartOfADay"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOfADay"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex37"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1460,6 +1633,33 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="StartOfADay">
|
||||
<short>Return the start of a day as a DateTime value, given a day indication</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>StartOfADay</var>
|
||||
returns a <var>TDateTime</var> value with the date/time indication of
|
||||
the start (0:0:0.000) of the day given by <var>AYear</var>,
|
||||
<var>AMonth</var>, <var>ADay</var>.
|
||||
</p>
|
||||
<p>
|
||||
The day may also be indicated with a <var>AYear</var>, <var>ADayOfYear</var> pair.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheDay"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOfTheDay"/>
|
||||
<link id="EndOfADay"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex38"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1490,6 +1690,33 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="EndOfADay">
|
||||
<short>Calculates a DateTime value representing the end of a specified day</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>EndOfADay</var>
|
||||
returns a <var>TDateTime</var> value with the date/time indication of
|
||||
the last moment (23:59:59.999) of the day given by <var>AYear</var>,
|
||||
<var>AMonth</var>, <var>ADay</var>.
|
||||
</p>
|
||||
<p>
|
||||
The day may also be indicated with a <var>AYear</var>, <var>ADayOfYear</var> pair.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="StartOfTheDay"/>
|
||||
<link id="StartOfADay"/>
|
||||
<link id="StartOfTheWeek"/>
|
||||
<link id="StartOfAWeek"/>
|
||||
<link id="StartOfAMonth"/>
|
||||
<link id="StartOfTheMonth"/>
|
||||
<link id="EndOfTheWeek"/>
|
||||
<link id="EndOfAWeek"/>
|
||||
<link id="EndOfTheYear"/>
|
||||
<link id="EndOfAYear"/>
|
||||
<link id="EndOfTheMonth"/>
|
||||
<link id="EndOfAMonth"/>
|
||||
<link id="EndOfTheDay"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex39"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1520,6 +1747,25 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="MonthOfTheYear">
|
||||
<short>Extract the month of a DateTime indication.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>MonthOfTheYear</var> extracts the month part of <var>Avalue</var> and
|
||||
returns it. It is an alias for <link id="MonthOf"/>, and is provided for
|
||||
completeness only, corresponding to the other <var>PartOfTheYear</var> functions.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="MonthOf"/>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1535,6 +1781,28 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="WeekOfTheYear">
|
||||
<short>Extract the week of the year (and optionally year) of a DateTime indication.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>WeekOfTheYear</var> extracts the week of the year from <var>Avalue</var> and
|
||||
returns it, and optionally returns the year as well. It returns the same value as <link id="WeekOf"/>.
|
||||
</p>
|
||||
<remark>
|
||||
Note that weeks are numbered from 1 using the ISO 8601 standard, and the day of the week as well.
|
||||
This means that the year may not be the same as the year part of the date, since the week may
|
||||
start in the previous year as the first week of the year is the week with at
|
||||
least 4 days in it.
|
||||
</remark>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOf"/>
|
||||
<link id="MonthOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
<example file="datutex/ex40"/>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1555,7 +1823,25 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
|
||||
<!-- function Visibility: default -->
|
||||
<element name="DayOfTheYear">
|
||||
<short>Extracts the day of the week from a DateTime value</short>
|
||||
<short>Extracts the day of the year from a <var>TDateTime</var> value</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>DayOfTheYear</var> returns the number of days that have passed since
|
||||
the start of the year till the moment indicated by
|
||||
<var>AValue</var>. This is a one-based number, i.e. January 1 will
|
||||
return 1.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1571,6 +1857,24 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="HourOfTheYear">
|
||||
<short>Calculate the number of hours passed since the start of the year.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>HourOfTheYear</var> returns the number of hours that have passed since
|
||||
the start of the year (January 1, 00:00:00) till the moment indicated by
|
||||
<var>AValue</var>. This is a zero-based number, i.e.
|
||||
January 1 00:59:59 will return 0.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1586,6 +1890,25 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="MinuteOfTheYear">
|
||||
<short>Calculate the number of minutes elapsed since the start of the year</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>MinuteOfTheYear</var> returns the number of minutes that have passed since
|
||||
the start of the year (January 1, 00:00:00) till the moment indicated by
|
||||
<var>AValue</var>. This is a zero-based number, i.e.
|
||||
January 1 00:00:59 will return 0.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1601,6 +1924,25 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="SecondOfTheYear">
|
||||
<short>Calculate the number of seconds elapsed since the start of the year.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>SecondOfTheYear</var> returns the number of seconds that have passed since
|
||||
the start of the year (January 1, 00:00:00) till the moment indicated by
|
||||
<var>AValue</var>. This is a zero-based number, i.e.
|
||||
January 1 00:00:00.999 will return 0.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
@ -1616,6 +1958,25 @@ returns a <var>TDateTime</var> value with the date of the last day of the year <
|
||||
<!-- function Visibility: default -->
|
||||
<element name="MilliSecondOfTheYear">
|
||||
<short>Calculate the number of milliseconds elapsed since the start of the year.</short>
|
||||
<descr>
|
||||
<p>
|
||||
<var>MilliSecondOfTheYear</var> returns the number of milliseconds that have passed since
|
||||
the start of the year (January 1, 00:00:00.000) till the moment indicated by
|
||||
<var>AValue</var>. This is a zero-based number, i.e.
|
||||
January 1 00:00:00.000 will return 0.
|
||||
</p>
|
||||
<p>
|
||||
For an example, see the <link id="WeekOfTheYear"/> function.
|
||||
</p>
|
||||
</descr>
|
||||
<seealso>
|
||||
<link id="WeekOfTheYear"/>
|
||||
<link id="DayOfTheYear"/>
|
||||
<link id="HourOfTheYear"/>
|
||||
<link id="MinuteOfTheYear"/>
|
||||
<link id="SecondOfTheYear"/>
|
||||
<link id="MilliSecondOfTheYear"/>
|
||||
</seealso>
|
||||
</element>
|
||||
|
||||
<!-- function result Visibility: default -->
|
||||
|
||||
@ -21,3 +21,19 @@ ex21.pp contains an example of the IsSameDay function.
|
||||
ex22.pp contains an example of the PreviousDayOfWeek function.
|
||||
ex23.pp contains an example of the YearOf function.
|
||||
ex24.pp contains an example of the StartOfTheYear function.
|
||||
ex25.pp contains an example of the EndOfTheYear function.
|
||||
ex26.pp contains an example of the StartOfAYearfunction.
|
||||
ex27.pp contains an example of the EndOfAYear function.
|
||||
ex28.pp contains an example of the StartOfTheMonth function.
|
||||
ex29.pp contains an example of the EndOfTheMonth function.
|
||||
ex30.pp contains an example of the StartOfAMonth function.
|
||||
ex31.pp contains an example of the EndOfAMonth function.
|
||||
ex32.pp contains an example of the StartOfTheWeek function.
|
||||
ex33.pp contains an example of the EndOfTheWeek function.
|
||||
ex34.pp contains an example of the StartOfAWeek function.
|
||||
ex35.pp contains an example of the EndOfAWeek function.
|
||||
ex36.pp contains an example of the StartOfTheDay function.
|
||||
ex37.pp contains an example of the EndOfTheDay function.
|
||||
ex38.pp contains an example of the StartOfADay function.
|
||||
ex34.pp contains an example of the EndOfADay function.
|
||||
ex40.pp contains an example of the WeekOfTheYear function.
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
Program Example25;
|
||||
Program Example27;
|
||||
|
||||
{ This program demonstrates the EndOfAYear function }
|
||||
|
||||
|
||||
12
docs/datutex/ex28.pp
Normal file
12
docs/datutex/ex28.pp
Normal file
@ -0,0 +1,12 @@
|
||||
Program Example28;
|
||||
|
||||
{ This program demonstrates the StartOfTheMonth function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"First day of this month : "dd mmmm yyyy';
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,StartOfTheMonth(Today)));
|
||||
End.
|
||||
12
docs/datutex/ex29.pp
Normal file
12
docs/datutex/ex29.pp
Normal file
@ -0,0 +1,12 @@
|
||||
Program Example29;
|
||||
|
||||
{ This program demonstrates the EndOfTheMonth function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"last day of this month : "dd mmmm yyyy';
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,EndOfTheMonth(Today)));
|
||||
End.
|
||||
16
docs/datutex/ex30.pp
Normal file
16
docs/datutex/ex30.pp
Normal file
@ -0,0 +1,16 @@
|
||||
Program Example30;
|
||||
|
||||
{ This program demonstrates the StartOfAMonth function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"First day of this month : "dd mmmm yyyy';
|
||||
Var
|
||||
Y,M : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
M:=MonthOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,StartOfAMonth(Y,M)));
|
||||
End.
|
||||
16
docs/datutex/ex31.pp
Normal file
16
docs/datutex/ex31.pp
Normal file
@ -0,0 +1,16 @@
|
||||
Program Example31;
|
||||
|
||||
{ This program demonstrates the EndOfAMonth function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"Last day of this month : "dd mmmm yyyy';
|
||||
Var
|
||||
Y,M : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
M:=MonthOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,EndOfAMonth(Y,M)));
|
||||
End.
|
||||
12
docs/datutex/ex32.pp
Normal file
12
docs/datutex/ex32.pp
Normal file
@ -0,0 +1,12 @@
|
||||
Program Example32;
|
||||
|
||||
{ This program demonstrates the StartOfTheWeek function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"First day of this week : "dd mmmm yyyy';
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,StartOfTheWeek(Today)));
|
||||
End.
|
||||
12
docs/datutex/ex33.pp
Normal file
12
docs/datutex/ex33.pp
Normal file
@ -0,0 +1,12 @@
|
||||
Program Example33;
|
||||
|
||||
{ This program demonstrates the EndOfTheWeek function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"last day of this week : "dd mmmm yyyy';
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,EndOfTheWeek(Today)));
|
||||
End.
|
||||
19
docs/datutex/ex34.pp
Normal file
19
docs/datutex/ex34.pp
Normal file
@ -0,0 +1,19 @@
|
||||
Program Example34;
|
||||
|
||||
{ This program demonstrates the StartOfAWeek function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"First day of this week : "dd mmmm yyyy hh:nn:ss';
|
||||
Fmt2 = '"Second day of this week : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
Var
|
||||
Y,W : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
W:=WeekOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,StartOfAWeek(Y,W)));
|
||||
Writeln(FormatDateTime(Fmt2,StartOfAWeek(Y,W,2)));
|
||||
End.
|
||||
19
docs/datutex/ex35.pp
Normal file
19
docs/datutex/ex35.pp
Normal file
@ -0,0 +1,19 @@
|
||||
Program Example35;
|
||||
|
||||
{ This program demonstrates the EndOfAWeek function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"Last day of this week : "dd mmmm yyyy hh:nn:ss';
|
||||
Fmt2 = '"Last-1 day of this week : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
Var
|
||||
Y,W : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
W:=WeekOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,EndOfAWeek(Y,W)));
|
||||
Writeln(FormatDateTime(Fmt2,EndOfAWeek(Y,W,6)));
|
||||
End.
|
||||
13
docs/datutex/ex36.pp
Normal file
13
docs/datutex/ex36.pp
Normal file
@ -0,0 +1,13 @@
|
||||
Program Example36;
|
||||
|
||||
{ This program demonstrates the StartOfTheDay function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"Start of the day : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,StartOfTheDay(Today)));
|
||||
End.
|
||||
13
docs/datutex/ex37.pp
Normal file
13
docs/datutex/ex37.pp
Normal file
@ -0,0 +1,13 @@
|
||||
Program Example37;
|
||||
|
||||
{ This program demonstrates the EndOfTheDay function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"End of the day : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
|
||||
Begin
|
||||
Writeln(FormatDateTime(Fmt,EndOfTheDay(Today)));
|
||||
End.
|
||||
20
docs/datutex/ex38.pp
Normal file
20
docs/datutex/ex38.pp
Normal file
@ -0,0 +1,20 @@
|
||||
Program Example36;
|
||||
|
||||
{ This program demonstrates the StartOfADay function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"Start of the day : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
Var
|
||||
Y,M,D : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
M:=MonthOf(Today);
|
||||
D:=DayOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,StartOfADay(Y,M,D)));
|
||||
DecodeDateDay(Today,Y,D);
|
||||
Writeln(FormatDateTime(Fmt,StartOfADay(Y,D)));
|
||||
End.
|
||||
20
docs/datutex/ex39.pp
Normal file
20
docs/datutex/ex39.pp
Normal file
@ -0,0 +1,20 @@
|
||||
Program Example36;
|
||||
|
||||
{ This program demonstrates the EndOfADay function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Const
|
||||
Fmt = '"End of the day : "dd mmmm yyyy hh:nn:ss';
|
||||
|
||||
Var
|
||||
Y,M,D : Word;
|
||||
|
||||
Begin
|
||||
Y:=YearOf(Today);
|
||||
M:=MonthOf(Today);
|
||||
D:=DayOf(Today);
|
||||
Writeln(FormatDateTime(Fmt,EndOfADay(Y,M,D)));
|
||||
DecodeDateDay(Today,Y,D);
|
||||
Writeln(FormatDateTime(Fmt,EndOfADay(Y,D)));
|
||||
End.
|
||||
20
docs/datutex/ex40.pp
Normal file
20
docs/datutex/ex40.pp
Normal file
@ -0,0 +1,20 @@
|
||||
Program Example40;
|
||||
|
||||
{ This program demonstrates the WeekOfTheYear function }
|
||||
|
||||
Uses SysUtils,DateUtils;
|
||||
|
||||
Var
|
||||
N : TDateTime;
|
||||
|
||||
Begin
|
||||
N:=Now;
|
||||
Writeln('Month of the year : ',MonthOfTheYear(N));
|
||||
Writeln('Week of the year : ',WeekOfTheYear(N));
|
||||
Writeln('Day of the year : ',DayOfTheYear(N));
|
||||
Writeln('Hour of the year : ',HourOfTheYear(N));
|
||||
Writeln('Minute of the year : ',MinuteOfTheYear(N));
|
||||
Writeln('Second of the year : ',SecondOfTheYear(N));
|
||||
Writeln('MilliSecond of the year : ',
|
||||
MilliSecondOfTheYear(N));
|
||||
End.
|
||||
Loading…
Reference in New Issue
Block a user