+ Second batch of descriptions and examples

docs/dateutils.xml

@@ -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 -->

docs/datutex/README

@@ -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.

docs/datutex/ex27.pp

@@ -1,4 +1,4 @@
-Program Example25;
+Program Example27;
 
 { This program demonstrates the EndOfAYear function }
 

docs/datutex/ex28.pp

@@ -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.

docs/datutex/ex29.pp

@@ -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.

docs/datutex/ex30.pp

@@ -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.

docs/datutex/ex31.pp

@@ -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.

docs/datutex/ex32.pp

@@ -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.

docs/datutex/ex33.pp

@@ -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.

docs/datutex/ex34.pp

@@ -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.

docs/datutex/ex35.pp

@@ -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.

docs/datutex/ex36.pp

@@ -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.

docs/datutex/ex37.pp

@@ -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.

docs/datutex/ex38.pp

@@ -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.

docs/datutex/ex39.pp

@@ -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.

docs/datutex/ex40.pp

@@ -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.