From b16a6b9e58bf0f9c261ca6c2d4ba4e65126df12a Mon Sep 17 00:00:00 2001 From: Steve Archer Date: Wed, 12 Jul 2017 15:05:04 -0500 Subject: [PATCH 1/2] docs: Clarify documentation of input[week] Add a note to documentation of input[week] to explicitly state that the resulting Date object's value is set to Thursday at midnight of the specified week Resolves #15883 --- src/ng/directive/input.js | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js index 182690a12310..2e368ea33957 100644 --- a/src/ng/directive/input.js +++ b/src/ng/directive/input.js @@ -457,6 +457,9 @@ var inputType = { * The model must always be a Date object, otherwise AngularJS will throw an error. * Invalid `Date` objects (dates whose `getTime()` is `NaN`) will be rendered as an empty string. * + * The value of the resulting Date object will be set to Thursday at 00:00:00 of the requested week, + * due to ISO-8601 week numbering standards. + * * The timezone to be used to read/write the `Date` instance in the model can be defined using * {@link ng.directive:ngModelOptions ngModelOptions}. By default, this is the timezone of the browser. * From e2082df1a9c2babc55102887dd042d627cf09467 Mon Sep 17 00:00:00 2001 From: Steve Archer Date: Wed, 12 Jul 2017 16:09:58 -0500 Subject: [PATCH 2/2] docs: Clarify documentation of input[week] Add a note to documentation of input[week] to explicitly state that the resulting Data object's value is set to Thursday at midnight of the specified week, and add a link to explain ISO's week numbering system Resolves #15883 --- src/ng/directive/input.js | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/ng/directive/input.js b/src/ng/directive/input.js index 2e368ea33957..73f6ef898c51 100644 --- a/src/ng/directive/input.js +++ b/src/ng/directive/input.js @@ -458,7 +458,8 @@ var inputType = { * Invalid `Date` objects (dates whose `getTime()` is `NaN`) will be rendered as an empty string. * * The value of the resulting Date object will be set to Thursday at 00:00:00 of the requested week, - * due to ISO-8601 week numbering standards. + * due to ISO-8601 week numbering standards. Information on ISO's system for numbering the weeks of the + * year can be found at: https://en.wikipedia.org/wiki/ISO_8601#Week_dates * * The timezone to be used to read/write the `Date` instance in the model can be defined using * {@link ng.directive:ngModelOptions ngModelOptions}. By default, this is the timezone of the browser.