Skip to content

Commit

Permalink
Merge pull request #208 from rdswift/date_clarification
Browse files Browse the repository at this point in the history
PICARD-2741: Modify description of date-related script functions
  • Loading branch information
rdswift authored Aug 31, 2023
2 parents da41a2a + 553ebf2 commit 5ed1676
Show file tree
Hide file tree
Showing 35 changed files with 815 additions and 305 deletions.
50 changes: 34 additions & 16 deletions _locale/de/LC_MESSAGES/functions/func_dateformat.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ msgid ""
msgstr ""
"Project-Id-Version: MusicBrainz Picard v2.7.0b1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-02-12 08:15-0700\n"
"POT-Creation-Date: 2023-08-31 13:31-0600\n"
"PO-Revision-Date: 2023-08-26 10:27+0000\n"
"Last-Translator: Philipp Wolfer <[email protected]>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/"
"picard-docs/functionsfunc_dateformat/de/>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/picard-"
"docs/functionsfunc_dateformat/de/>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand All @@ -26,7 +26,7 @@ msgid "$dateformat"
msgstr ""

#: ../../functions/func_dateformat.rst:8
msgid "Usage: **$dateformat(date,[format],[date_order])**"
msgid "Usage: **$dateformat(date,[format],[date order])**"
msgstr ""

#: ../../functions/func_dateformat.rst:9
Expand All @@ -46,42 +46,60 @@ msgid ""
"Returns the input ``date`` in the specified ``format``, which is based on "
"the standard Python ``strftime`` `format codes <https://strftime.org>`_. If "
"no ``format`` is specified the date will be returned in the form "
"'2020-02-15'."
"'2020-02-15' (year, month, day)."
msgstr ""

#: ../../functions/func_dateformat.rst:18
#: ../../functions/func_dateformat.rst:16
msgid ""
"The \"year\", \"month\" and \"day\" portions of the date must be entered as "
"numbers, and can be separated by any non-numeric characters. The default "
"order for the input date is \"ymd\". This can be changed by specifying a "
"``date_order`` of either \"dmy\" or \"mdy\"."
"order for the input date is \"ymd\" (year, month, day). This can be changed "
"by specifying a ``date order``."
msgstr ""

#: ../../functions/func_dateformat.rst:18
msgid "Valid entries for ``date order`` are:"
msgstr ""

#: ../../functions/func_dateformat.rst:20
msgid "**ymd** - year, month, day (This is the default order.)"
msgstr ""

#: ../../functions/func_dateformat.rst:21
msgid "**dmy** - day, month, year"
msgstr ""

#: ../../functions/func_dateformat.rst:22
msgid "**mdy** - month, day, year"
msgstr ""

#: ../../functions/func_dateformat.rst:24
msgid ""
"If either the ``date`` or ``format`` are invalid an empty string will be "
"returned."
"returned. If an invalid ``date order`` is specified, the default order "
"\"ymd\" will be used."
msgstr ""

#: ../../functions/func_dateformat.rst:26
#: ../../functions/func_dateformat.rst:28
msgid ""
"Any special characters such as '%', '$', '(', ')' and '\\\\' will need to be "
"escaped as shown in the examples below."
msgstr ""

#: ../../functions/func_dateformat.rst:31
#: ../../functions/func_dateformat.rst:32
msgid ""
"Platform-specific formatting codes should be avoided to help ensure the "
"portability of scripts across the different platforms. These codes include: "
"remove zero-padding (e.g.: ``%-d`` and ``%-m`` on Linux or macOS, and their "
"equivalent ``%#d`` and ``%#m`` on Windows); element length specifiers (e.g.: "
"``%3Y``); and hanging '%' at the end of the format string."
"equivalents ``%#d`` and ``%#m`` on Windows); element length specifiers (e."
"g.: ``%3Y``); and hanging '%' at the end of the format string."
msgstr ""

#: ../../functions/func_dateformat.rst:37
msgid "**Example:**"
#: ../../functions/func_dateformat.rst:35
#, fuzzy
msgid "**Examples:**"
msgstr "**Beispiel:**"

#: ../../functions/func_dateformat.rst:39
#: ../../functions/func_dateformat.rst:37
msgid "The following statements will return the values indicated:"
msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"
21 changes: 11 additions & 10 deletions _locale/de/LC_MESSAGES/functions/func_datetime.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ msgid ""
msgstr ""
"Project-Id-Version: MusicBrainz Picard v2.6.3\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-02-12 08:15-0700\n"
"POT-Creation-Date: 2023-08-31 13:31-0600\n"
"PO-Revision-Date: 2023-08-26 10:27+0000\n"
"Last-Translator: Philipp Wolfer <[email protected]>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/"
"picard-docs/functionsfunc_datetime/de/>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/picard-"
"docs/functionsfunc_datetime/de/>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand Down Expand Up @@ -49,25 +49,26 @@ msgid ""
"'2020-02-15 14:26:32'."
msgstr ""

#: ../../functions/func_datetime.rst:20
#: ../../functions/func_datetime.rst:18
msgid ""
"Any special characters such as '%', '$', '(', ')' and '\\\\' will need to be "
"escaped as shown in the examples below."
msgstr ""

#: ../../functions/func_datetime.rst:25
#: ../../functions/func_datetime.rst:22
msgid ""
"Platform-specific formatting codes should be avoided to help ensure the "
"portability of scripts across the different platforms. These codes include: "
"remove zero-padding (e.g.: ``%-d`` and ``%-m`` on Linux or macOS, and their "
"equivalent ``%#d`` and ``%#m`` on Windows); element length specifiers (e.g.: "
"``%3Y``); and hanging '%' at the end of the format string."
"equivalents ``%#d`` and ``%#m`` on Windows); element length specifiers (e."
"g.: ``%3Y``); and hanging '%' at the end of the format string."
msgstr ""

#: ../../functions/func_datetime.rst:31
msgid "**Example:**"
#: ../../functions/func_datetime.rst:25
#, fuzzy
msgid "**Examples:**"
msgstr "**Beispiel:**"

#: ../../functions/func_datetime.rst:33
#: ../../functions/func_datetime.rst:27
msgid "The following statements will return the values indicated:"
msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"
40 changes: 31 additions & 9 deletions _locale/de/LC_MESSAGES/functions/func_day.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ msgid ""
msgstr ""
"Project-Id-Version: MusicBrainz Picard v2.7.0b1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-14 08:09+0100\n"
"POT-Creation-Date: 2023-08-31 13:31-0600\n"
"PO-Revision-Date: 2023-08-26 10:27+0000\n"
"Last-Translator: Philipp Wolfer <[email protected]>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/"
"picard-docs/functionsfunc_day/de/>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/picard-"
"docs/functionsfunc_day/de/>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand All @@ -26,7 +26,7 @@ msgid "$day"
msgstr ""

#: ../../functions/func_day.rst:8
msgid "Usage: **$day(date[,date_order])**"
msgid "Usage: **$day(date[,date order])**"
msgstr ""

#: ../../functions/func_day.rst:9
Expand All @@ -49,15 +49,37 @@ msgstr ""
msgid ""
"The \"year\", \"month\" and \"day\" portions of the date must be entered as "
"numbers, and can be separated by any non-numeric characters. The default "
"order for the input date is \"ymd\". This can be changed by specifying a "
"``date_order`` of either \"dmy\" or \"mdy\". If anything other than \"ymd"
"\", \"dmy\" or \"mdy\" is specified, the default order \"ymd\" will be used."
"order for the input date is \"ymd\" (year, month, day). This can be changed "
"by specifying a ``date order``."
msgstr ""

#: ../../functions/func_day.rst:18
msgid "Valid entries for ``date order`` are:"
msgstr ""

#: ../../functions/func_day.rst:20
msgid "**ymd** - year, month, day (This is the default order.)"
msgstr ""

#: ../../functions/func_day.rst:21
msgid "**dmy** - day, month, year"
msgstr ""

#: ../../functions/func_day.rst:22
msgid "**Example:**"
msgstr "**Beispiel:**"
msgid "**mdy** - month, day, year"
msgstr ""

#: ../../functions/func_day.rst:24
msgid ""
"If the ``date`` is invalid an empty string will be returned. If an invalid "
"``date order`` is specified, the default order \"ymd\" will be used."
msgstr ""

#: ../../functions/func_day.rst:27
#, fuzzy
msgid "**Examples:**"
msgstr "**Beispiel:**"

#: ../../functions/func_day.rst:29
msgid "The following statements will return the values indicated:"
msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"
40 changes: 31 additions & 9 deletions _locale/de/LC_MESSAGES/functions/func_month.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ msgid ""
msgstr ""
"Project-Id-Version: MusicBrainz Picard v2.7.0b1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-14 08:09+0100\n"
"POT-Creation-Date: 2023-08-31 13:31-0600\n"
"PO-Revision-Date: 2023-08-26 10:27+0000\n"
"Last-Translator: Philipp Wolfer <[email protected]>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/"
"picard-docs/functionsfunc_month/de/>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/picard-"
"docs/functionsfunc_month/de/>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand All @@ -26,7 +26,7 @@ msgid "$month"
msgstr ""

#: ../../functions/func_month.rst:8
msgid "Usage: **$month(date[,date_order])**"
msgid "Usage: **$month(date[,date order])**"
msgstr ""

#: ../../functions/func_month.rst:9
Expand All @@ -49,15 +49,37 @@ msgstr ""
msgid ""
"The \"year\", \"month\" and \"day\" portions of the date must be entered as "
"numbers, and can be separated by any non-numeric characters. The default "
"order for the input date is \"ymd\". This can be changed by specifying a "
"``date_order`` of either \"dmy\" or \"mdy\". If anything other than \"ymd"
"\", \"dmy\" or \"mdy\" is specified, the default order \"ymd\" will be used."
"order for the input date is \"ymd\" (year, month, day). This can be changed "
"by specifying a ``date order``."
msgstr ""

#: ../../functions/func_month.rst:18
msgid "Valid entries for ``date order`` are:"
msgstr ""

#: ../../functions/func_month.rst:20
msgid "**ymd** - year, month, day (This is the default order.)"
msgstr ""

#: ../../functions/func_month.rst:21
msgid "**dmy** - day, month, year"
msgstr ""

#: ../../functions/func_month.rst:22
msgid "**Example:**"
msgstr "**Beispiel:**"
msgid "**mdy** - month, day, year"
msgstr ""

#: ../../functions/func_month.rst:24
msgid ""
"If the ``date`` is invalid an empty string will be returned. If an invalid "
"``date order`` is specified, the default order \"ymd\" will be used."
msgstr ""

#: ../../functions/func_month.rst:27
#, fuzzy
msgid "**Examples:**"
msgstr "**Beispiel:**"

#: ../../functions/func_month.rst:29
msgid "The following statements will return the values indicated:"
msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"
40 changes: 31 additions & 9 deletions _locale/de/LC_MESSAGES/functions/func_year.po
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ msgid ""
msgstr ""
"Project-Id-Version: MusicBrainz Picard v2.7.0b1\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2023-03-14 08:09+0100\n"
"POT-Creation-Date: 2023-08-31 13:31-0600\n"
"PO-Revision-Date: 2023-08-26 10:27+0000\n"
"Last-Translator: Philipp Wolfer <[email protected]>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/"
"picard-docs/functionsfunc_year/de/>\n"
"Language-Team: German <https://translations.metabrainz.org/projects/picard-"
"docs/functionsfunc_year/de/>\n"
"Language: de\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
Expand All @@ -26,7 +26,7 @@ msgid "$year"
msgstr ""

#: ../../functions/func_year.rst:8
msgid "Usage: **$year(date[,date_order])**"
msgid "Usage: **$year(date[,date order])**"
msgstr ""

#: ../../functions/func_year.rst:9
Expand All @@ -49,15 +49,37 @@ msgstr ""
msgid ""
"The \"year\", \"month\" and \"day\" portions of the date must be entered as "
"numbers, and can be separated by any non-numeric characters. The default "
"order for the input date is \"ymd\". This can be changed by specifying a "
"``date_order`` of either \"dmy\" or \"mdy\". If anything other than \"ymd"
"\", \"dmy\" or \"mdy\" is specified, the default order \"ymd\" will be used."
"order for the input date is \"ymd\" (year, month, day). This can be changed "
"by specifying a ``date order``."
msgstr ""

#: ../../functions/func_year.rst:18
msgid "Valid entries for ``date order`` are:"
msgstr ""

#: ../../functions/func_year.rst:20
msgid "**ymd** - year, month, day (This is the default order.)"
msgstr ""

#: ../../functions/func_year.rst:21
msgid "**dmy** - day, month, year"
msgstr ""

#: ../../functions/func_year.rst:22
msgid "**Example:**"
msgstr "**Beispiel:**"
msgid "**mdy** - month, day, year"
msgstr ""

#: ../../functions/func_year.rst:24
msgid ""
"If the ``date`` is invalid an empty string will be returned. If an invalid "
"``date order`` is specified, the default order \"ymd\" will be used."
msgstr ""

#: ../../functions/func_year.rst:27
#, fuzzy
msgid "**Examples:**"
msgstr "**Beispiel:**"

#: ../../functions/func_year.rst:29
msgid "The following statements will return the values indicated:"
msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"
Loading

0 comments on commit 5ed1676

Please sign in to comment.