[Libreoffice-commits] help.git: 2 commits - source/text

Thu May 4 17:56:22 UTC 2017

source/text/sbasic/shared/03030108.xhp     |   13 +++++++++----
 source/text/sbasic/shared/03030108.xhp.rej |   14 ++++++++++++++
 2 files changed, 23 insertions(+), 4 deletions(-)

New commits:
commit ba4ed13b45fc390205c1f888f805b56c62994a11
Author: Eike Rathke <erack at redhat.com>
Date:   Thu May 4 19:55:13 2017 +0200

    CDateFromIso: also with separators; date range and year representation
    
    Change-Id: Ifd83a84b300074be10fe039ba2e30b94f6bf1327

diff --git a/source/text/sbasic/shared/03030108.xhp b/source/text/sbasic/shared/03030108.xhp
index cc780b0bc..63b47a236 100644
--- a/source/text/sbasic/shared/03030108.xhp
+++ b/source/text/sbasic/shared/03030108.xhp
@@ -34,7 +34,11 @@
 <bookmark xml-lang="en-US" branch="index" id="bm_id3153127"><bookmark_value>CdateFromIso function</bookmark_value>
 </bookmark>
 <paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030108.xhp" name="CDateFromIso Function [Runtime]">CDateFromIso Function [Runtime]</link></paragraph>
-<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the internal date number from a string that contains a date in ISO format.</paragraph>
+<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the internal date number from a string that contains a date in ISO format (YYYYMMDD or YYYY-MM-DD).</paragraph>
+<paragraph id="par_id3148551" role="paragraph" xml-lang="en-US">The year part must consist of either two (supported only in YYMMDD format without separators for compatibility) or at least four digits. With four digits leading zeros must be given if the absolute value is less than 1000, it can be negative with a leading minus sign if the date passed denotes a year before the common area (BCE) and it can have more than four digits if the absolute value is greater than 9999. The formatted string can be in the range "-327680101" to "327671231", or "-32768-01-01" to "32767-12-31".</paragraph>
+<paragraph id="par_id3148552" role="paragraph" xml-lang="en-US">An invalid date results in an error. Year 0 is not accepted, the last day BCE is -0001-12-31 and the next day CE is 0001-01-01. Dates before 1582-10-15 are in the proleptic Gregorian calendar.</paragraph>
+<paragraph id="par_id3148553" role="tip" xml-lang="en-US">When converting a date serial number to a printable string, for example for the Print or MsgBox command, the locale's default calendar is used and at that 1582-10-15 cutover date may switch to the Julian calendar, which can result in a different date being displayed than expected. Use the <link href="text/sbasic/shared/03030107.xhp" name="CDateToIso Function [Runtime]">CDateToIso Function [Runtime]</link> to convert such date number to a string representation in the proleptic Gregorian calendar.</paragraph>
+<paragraph id="par_id3148554" role="note" xml-lang="en-US">The YYYY-MM-DD format with separators is supported since %PRODUCTNAME 5.3.4. Years less than 100 or greater than 9999 are accepted since %PRODUCTNAME 5.4 if not in VBA compatibility mode.</paragraph>
 </section>
 <paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph>
 <bascode>
@@ -44,11 +48,12 @@
 <paragraph role="paragraph" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="6">Internal date number</paragraph>
 <paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="2" l10n="U" oldref="7">Parameters:</paragraph>
 <paragraph role="paragraph" id="par_id3154685" xml-lang="en-US" l10n="U" oldref="8">
-<emph>String:</emph> A string that contains a date in ISO format. The year may have two or four digits.</paragraph>
+<emph>String:</emph> A string that contains a date in ISO format.</paragraph>
 <embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
 <embed href="text/sbasic/shared/00000003.xhp#err5"/>
 <paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="2" l10n="U" oldref="9">Example:</paragraph>
-<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US" l10n="U" oldref="10">dateval = CDateFromIso("20021231")</paragraph>
-<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US" l10n="U" oldref="11">returns 12/31/2002 in the date format of your system</paragraph>
+<paragraph role="paragraph" id="par_id3147318" xml-lang="en-US">dateval = CDateFromIso("20021231")</paragraph>
+<paragraph role="paragraph" id="par_id3147319" xml-lang="en-US">dateval = CDateFromIso("2002-12-31")</paragraph>
+<paragraph role="paragraph" id="par_id3146921" xml-lang="en-US">return both 12/31/2002 in the date format of your system</paragraph>
 </body>
 </helpdocument>
commit ef3d847d9a93abd7e183a1babf9652ca729c8c49
Author: Eike Rathke <erack at redhat.com>
Date:   Thu May 4 19:42:40 2017 +0200

    CDateFromIso: also with separators; date range and year representation
    
    Change-Id: Ib946c3654805f8ae4bff1c7e3a0a26083bfb8df6

diff --git a/source/text/sbasic/shared/03030108.xhp.rej b/source/text/sbasic/shared/03030108.xhp.rej
new file mode 100644
index 000000000..45fcd1f0f
--- /dev/null
+++ b/source/text/sbasic/shared/03030108.xhp.rej
@@ -0,0 +1,14 @@
+diff a/source/text/sbasic/shared/03030108.xhp b/source/text/sbasic/shared/03030108.xhp	(rejected hunks)
+@@ -34,7 +34,11 @@
+ <bookmark xml-lang="en-US" branch="index" id="bm_id3153127"><bookmark_value>CdateFromIso function</bookmark_value>
+ </bookmark>
+ <paragraph role="heading" id="hd_id3153127" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/sbasic/shared/03030108.xhp" name="CDateFromIso Function [Runtime]">CDateFromIso Function [Runtime]</link></paragraph>
+-<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the internal date number from a string that contains a date in ISO format.</paragraph>
++<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US" l10n="U" oldref="2">Returns the internal date number from a string that contains a date in ISO format (YYYYMMDD or YYYY-MM-DD).</paragraph>
++<paragraph id="par_id3148551" role="paragraph" xml-lang="en-US">The year part must consist of either two (supported only in YYMMDD format without separators for compatibility) or at least four digits. With four digits leading zeros must be given if the absolute value is less than 1000, it can be negative with a leading minus sign if the date passed denotes a year before the common area (BCE) and it can have more than four digits if the absolute value is greater than 9999. The formatted string can be in the range "-327680101" to "327671231", or "-32768-01-01" to "32767-12-31".</paragraph>
++<paragraph id="par_id3148552" role="paragraph" xml-lang="en-US">An invalid date results in an error. Year 0 is not accepted, the last day BCE is -0001-12-31 and the next day CE is 0001-01-01. Dates before 1582-10-15 are in the proleptic Gregorian calendar.</paragraph>
++<paragraph id="par_id3148553" role="tip" xml-lang="en-US">When converting a date serial number to a printable string, for example for the Print or MsgBox command, the locale's default calendar is used and at that 1582-10-15 cutover date may switch to the Julian calendar, which can result in a different date being displayed than expected. Use the <link href="text/sbasic/shared/03030107.xhp" name="CDateToIso Function [Runtime]">CDateToIso Function [Runtime]</link> to convert such date number to a string representation in the proleptic Gregorian calendar.</paragraph>
++<paragraph id="par_id3148554" role="note" xml-lang="en-US">The YYYY-MM-DD format with separators is supported since %PRODUCTNAME 5.3.4. Years less than 100 or greater than 9999 are accepted since %PRODUCTNAME 5.4 if not in VBA compatibility mode.</paragraph>
+ </section>
+ <paragraph role="heading" id="hd_id3148947" xml-lang="en-US" level="2" l10n="U" oldref="3">Syntax:</paragraph>
+ <bascode>
