|
16 | 16 | // to be loaded as the JS file. |
17 | 17 |
|
18 | 18 | /** |
19 | | - * Represents a whole calendar date, e.g. date of birth. The time of day and |
20 | | - * time zone are either specified elsewhere or are not significant. The date |
21 | | - * is relative to the Proleptic Gregorian Calendar. The day may be 0 to |
22 | | - * represent a year and month where the day is not significant, e.g. credit card |
23 | | - * expiration date. The year may be 0 to represent a month and day independent |
24 | | - * of year, e.g. anniversary date. Related types are |
25 | | - * google.type.TimeOfDay and |
26 | | - * `google.protobuf.Timestamp`. |
| 19 | + * Represents a whole or partial calendar date, e.g. a birthday. The time of day |
| 20 | + * and time zone are either specified elsewhere or are not significant. The date |
| 21 | + * is relative to the Proleptic Gregorian Calendar. This can represent: |
| 22 | + * |
| 23 | + * * A full date, with non-zero year, month and day values |
| 24 | + * * A month and day value, with a zero year, e.g. an anniversary |
| 25 | + * * A year on its own, with zero month and day values |
| 26 | + * * A year and month value, with a zero day, e.g. a credit card expiration date |
| 27 | + * |
| 28 | + * Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`. |
27 | 29 | * |
28 | 30 | * @property {number} year |
29 | 31 | * Year of date. Must be from 1 to 9999, or 0 if specifying a date without |
30 | 32 | * a year. |
31 | 33 | * |
32 | 34 | * @property {number} month |
33 | | - * Month of year. Must be from 1 to 12. |
| 35 | + * Month of year. Must be from 1 to 12, or 0 if specifying a year without a |
| 36 | + * month and day. |
34 | 37 | * |
35 | 38 | * @property {number} day |
36 | 39 | * Day of month. Must be from 1 to 31 and valid for the year and month, or 0 |
37 | | - * if specifying a year/month where the day is not significant. |
| 40 | + * if specifying a year by itself or a year and month where the day is not |
| 41 | + * significant. |
38 | 42 | * |
39 | 43 | * @typedef Date |
40 | 44 | * @memberof google.type |
|
0 commit comments