Liking cljdoc? Tell your friends :D

jdk.time.temporal.WeekFields

Localized definitions of the day-of-week, week-of-month and week-of-year fields.

A standard week is seven days long, but cultures have different definitions for some other aspects of a week. This class represents the definition of the week, for the purpose of providing TemporalField instances.

WeekFields provides five fields, dayOfWeek(), weekOfMonth(), weekOfYear(), weekOfWeekBasedYear(), and weekBasedYear() that provide access to the values from any java.time.temporal.temporal object.

The computations for day-of-week, week-of-month, and week-of-year are based on the proleptic-year, month-of-year, day-of-month, and ISO day-of-week which are based on the epoch-day and the chronology. The values may not be aligned with the year-of-Era depending on the Chronology. A week is defined by:

The first day-of-week. For example, the ISO-8601 standard considers Monday to be the first day-of-week. The minimal number of days in the first week. For example, the ISO-8601 standard counts the first week as needing at least 4 days.

Together these two values allow a year or month to be divided into weeks.

Week of Month One field is used: week-of-month. The calculation ensures that weeks never overlap a month boundary. The month is divided into periods where each period starts on the defined first day-of-week. The earliest period is referred to as week 0 if it has less than the minimal number of days and week 1 if it has at least the minimal number of days.

Examples of WeekFields DateDay-of-week First day: MondayMinimal days: 4First day: MondayMinimal days: 5 2008-12-31Wednesday Week 5 of December 2008Week 5 of December 2008 2009-01-01Thursday Week 1 of January 2009Week 0 of January 2009 2009-01-04Sunday Week 1 of January 2009Week 0 of January 2009 2009-01-05Monday Week 2 of January 2009Week 1 of January 2009

Week of Year One field is used: week-of-year. The calculation ensures that weeks never overlap a year boundary. The year is divided into periods where each period starts on the defined first day-of-week. The earliest period is referred to as week 0 if it has less than the minimal number of days and week 1 if it has at least the minimal number of days.

Week Based Year Two fields are used for week-based-year, one for the week-of-week-based-year and one for week-based-year. In a week-based-year, each week belongs to only a single year. Week 1 of a year is the first week that starts on the first day-of-week and has at least the minimum number of days. The first and last weeks of a year may contain days from the previous calendar year or next calendar year respectively.

Examples of WeekFields for week-based-year DateDay-of-week First day: MondayMinimal days: 4First day: MondayMinimal days: 5 2008-12-31Wednesday Week 1 of 2009Week 53 of 2008 2009-01-01Thursday Week 1 of 2009Week 53 of 2008 2009-01-04Sunday Week 1 of 2009Week 53 of 2008 2009-01-05Monday Week 2 of 2009Week 1 of 2009

Localized definitions of the day-of-week, week-of-month and week-of-year fields.

A standard week is seven days long, but cultures have different definitions for some
other aspects of a week. This class represents the definition of the week, for the
purpose of providing TemporalField instances.

WeekFields provides five fields,
dayOfWeek(), weekOfMonth(), weekOfYear(),
weekOfWeekBasedYear(), and weekBasedYear()
that provide access to the values from any java.time.temporal.temporal object.

The computations for day-of-week, week-of-month, and week-of-year are based
on the  proleptic-year,
month-of-year,
day-of-month, and
ISO day-of-week which are based on the
epoch-day and the chronology.
The values may not be aligned with the year-of-Era
depending on the Chronology.
A week is defined by:

The first day-of-week.
For example, the ISO-8601 standard considers Monday to be the first day-of-week.
The minimal number of days in the first week.
For example, the ISO-8601 standard counts the first week as needing at least 4 days.

Together these two values allow a year or month to be divided into weeks.

Week of Month
One field is used: week-of-month.
The calculation ensures that weeks never overlap a month boundary.
The month is divided into periods where each period starts on the defined first day-of-week.
The earliest period is referred to as week 0 if it has less than the minimal number of days
and week 1 if it has at least the minimal number of days.


Examples of WeekFields
DateDay-of-week
 First day: MondayMinimal days: 4First day: MondayMinimal days: 5
2008-12-31Wednesday
 Week 5 of December 2008Week 5 of December 2008
2009-01-01Thursday
 Week 1 of January 2009Week 0 of January 2009
2009-01-04Sunday
 Week 1 of January 2009Week 0 of January 2009
2009-01-05Monday
 Week 2 of January 2009Week 1 of January 2009


Week of Year
One field is used: week-of-year.
The calculation ensures that weeks never overlap a year boundary.
The year is divided into periods where each period starts on the defined first day-of-week.
The earliest period is referred to as week 0 if it has less than the minimal number of days
and week 1 if it has at least the minimal number of days.

Week Based Year
Two fields are used for week-based-year, one for the
week-of-week-based-year and one for
week-based-year.  In a week-based-year, each week
belongs to only a single year.  Week 1 of a year is the first week that
starts on the first day-of-week and has at least the minimum number of days.
The first and last weeks of a year may contain days from the
previous calendar year or next calendar year respectively.


Examples of WeekFields for week-based-year
DateDay-of-week
 First day: MondayMinimal days: 4First day: MondayMinimal days: 5
2008-12-31Wednesday
 Week 1 of 2009Week 53 of 2008
2009-01-01Thursday
 Week 1 of 2009Week 53 of 2008
2009-01-04Sunday
 Week 1 of 2009Week 53 of 2008
2009-01-05Monday
 Week 2 of 2009Week 1 of 2009
raw docstring

*-isoclj

Static Constant.

The ISO-8601 definition, where a week starts on Monday and the first week has a minimum of 4 days.

The ISO-8601 standard defines a calendar system based on weeks. It uses the week-based-year and week-of-week-based-year concepts to split up the passage of days instead of the standard year/month/day.

Note that the first week may start in the previous calendar year. Note also that the first few days of a calendar year may be in the week-based-year corresponding to the previous calendar year.

type: java.time.temporal.WeekFields

Static Constant.

The ISO-8601 definition, where a week starts on Monday and the first week
 has a minimum of 4 days.

 The ISO-8601 standard defines a calendar system based on weeks.
 It uses the week-based-year and week-of-week-based-year concepts to split
 up the passage of days instead of the standard year/month/day.

 Note that the first week may start in the previous calendar year.
 Note also that the first few days of a calendar year may be in the
 week-based-year corresponding to the previous calendar year.

type: java.time.temporal.WeekFields
raw docstring

*-sunday-startclj

Static Constant.

The common definition of a week that starts on Sunday and the first week has a minimum of 1 day.

Defined as starting on Sunday and with a minimum of 1 day in the month. This week definition is in use in the US and other European countries.

type: java.time.temporal.WeekFields

Static Constant.

The common definition of a week that starts on Sunday and the first week
 has a minimum of 1 day.

 Defined as starting on Sunday and with a minimum of 1 day in the month.
 This week definition is in use in the US and other European countries.

type: java.time.temporal.WeekFields
raw docstring

*-week-based-yearsclj

Static Constant.

The unit that represents week-based-years for the purpose of addition and subtraction.

This allows a number of week-based-years to be added to, or subtracted from, a date. The unit is equal to either 52 or 53 weeks. The estimated duration of a week-based-year is the same as that of a standard ISO year at 365.2425 Days.

The rules for addition add the number of week-based-years to the existing value for the week-based-year field retaining the week-of-week-based-year and day-of-week, unless the week number it too large for the target year. In that case, the week is set to the last week of the year with the same day-of-week.

This unit is an immutable and thread-safe singleton.

type: java.time.temporal.TemporalUnit

Static Constant.

The unit that represents week-based-years for the purpose of addition and subtraction.

 This allows a number of week-based-years to be added to, or subtracted from, a date.
 The unit is equal to either 52 or 53 weeks.
 The estimated duration of a week-based-year is the same as that of a standard ISO
 year at 365.2425 Days.

 The rules for addition add the number of week-based-years to the existing value
 for the week-based-year field retaining the week-of-week-based-year
 and day-of-week, unless the week number it too large for the target year.
 In that case, the week is set to the last week of the year
 with the same day-of-week.

 This unit is an immutable and thread-safe singleton.

type: java.time.temporal.TemporalUnit
raw docstring

*ofclj

(*of locale)
(*of first-day-of-week minimal-days-in-first-week)

Obtains an instance of WeekFields from the first day-of-week and minimal days.

The first day-of-week defines the ISO DayOfWeek that is day 1 of the week. The minimal number of days in the first week defines how many days must be present in a month or year, starting from the first day-of-week, before the week is counted as the first week. A value of 1 will count the first day of the month or year as part of the first week, whereas a value of 7 will require the whole seven days to be in the new month or year.

WeekFields instances are singletons; for each unique combination of firstDayOfWeek and minimalDaysInFirstWeek the the same instance will be returned.

first-day-of-week - the first day of the week, not null - java.time.DayOfWeek minimal-days-in-first-week - the minimal number of days in the first week, from 1 to 7 - int

returns: the week-definition, not null - java.time.temporal.WeekFields

throws: java.lang.IllegalArgumentException - if the minimal days value is less than one or greater than 7

Obtains an instance of WeekFields from the first day-of-week and minimal days.

 The first day-of-week defines the ISO DayOfWeek that is day 1 of the week.
 The minimal number of days in the first week defines how many days must be present
 in a month or year, starting from the first day-of-week, before the week is counted
 as the first week. A value of 1 will count the first day of the month or year as part
 of the first week, whereas a value of 7 will require the whole seven days to be in
 the new month or year.

 WeekFields instances are singletons; for each unique combination
 of firstDayOfWeek and minimalDaysInFirstWeek the
 the same instance will be returned.

first-day-of-week - the first day of the week, not null - `java.time.DayOfWeek`
minimal-days-in-first-week - the minimal number of days in the first week, from 1 to 7 - `int`

returns: the week-definition, not null - `java.time.temporal.WeekFields`

throws: java.lang.IllegalArgumentException - if the minimal days value is less than one or greater than 7
raw docstring

day-of-weekclj

(day-of-week this)

Returns a field to access the day of week based on this WeekFields.

This is similar to ChronoField.DAY_OF_WEEK but uses values for the day-of-week based on this WeekFields. The days are numbered from 1 to 7 where the first day-of-week is assigned the value 1.

For example, if the first day-of-week is Sunday, then that will have the value 1, with other days ranging from Monday as 2 to Saturday as 7.

In the resolving phase of parsing, a localized day-of-week will be converted to a standardized ChronoField day-of-week. The day-of-week must be in the valid range 1 to 7. Other fields in this class build dates using the standardized day-of-week.

returns: a field providing access to the day-of-week with localized numbering, not null - java.time.temporal.TemporalField

Returns a field to access the day of week based on this WeekFields.

 This is similar to ChronoField.DAY_OF_WEEK but uses values for
 the day-of-week based on this WeekFields.
 The days are numbered from 1 to 7 where the
 first day-of-week is assigned the value 1.

 For example, if the first day-of-week is Sunday, then that will have the
 value 1, with other days ranging from Monday as 2 to Saturday as 7.

 In the resolving phase of parsing, a localized day-of-week will be converted
 to a standardized ChronoField day-of-week.
 The day-of-week must be in the valid range 1 to 7.
 Other fields in this class build dates using the standardized day-of-week.

returns: a field providing access to the day-of-week with localized numbering, not null - `java.time.temporal.TemporalField`
raw docstring

equalsclj

(equals this object)

Checks if this WeekFields is equal to the specified object.

The comparison is based on the entire state of the rules, which is the first day-of-week and minimal days.

object - the other rules to compare to, null returns false - java.lang.Object

returns: true if this is equal to the specified rules - boolean

Checks if this WeekFields is equal to the specified object.

 The comparison is based on the entire state of the rules, which is
 the first day-of-week and minimal days.

object - the other rules to compare to, null returns false - `java.lang.Object`

returns: true if this is equal to the specified rules - `boolean`
raw docstring

get-first-day-of-weekclj

(get-first-day-of-week this)

Gets the first day-of-week.

The first day-of-week varies by culture. For example, the US uses Sunday, while France and the ISO-8601 standard use Monday. This method returns the first day using the standard DayOfWeek enum.

returns: the first day-of-week, not null - java.time.DayOfWeek

Gets the first day-of-week.

 The first day-of-week varies by culture.
 For example, the US uses Sunday, while France and the ISO-8601 standard use Monday.
 This method returns the first day using the standard DayOfWeek enum.

returns: the first day-of-week, not null - `java.time.DayOfWeek`
raw docstring

get-minimal-days-in-first-weekclj

(get-minimal-days-in-first-week this)

Gets the minimal number of days in the first week.

The number of days considered to define the first week of a month or year varies by culture. For example, the ISO-8601 requires 4 days (more than half a week) to be present before counting the first week.

returns: the minimal number of days in the first week of a month or year, from 1 to 7 - int

Gets the minimal number of days in the first week.

 The number of days considered to define the first week of a month or year
 varies by culture.
 For example, the ISO-8601 requires 4 days (more than half a week) to
 be present before counting the first week.

returns: the minimal number of days in the first week of a month or year, from 1 to 7 - `int`
raw docstring

hash-codeclj

(hash-code this)

A hash code for this WeekFields.

returns: a suitable hash code - int

A hash code for this WeekFields.

returns: a suitable hash code - `int`
raw docstring

to-stringclj

(to-string this)

A string representation of this WeekFields instance.

returns: the string representation, not null - java.lang.String

A string representation of this WeekFields instance.

returns: the string representation, not null - `java.lang.String`
raw docstring

week-based-yearclj

(week-based-year this)

Returns a field to access the year of a week-based-year based on this WeekFields.

This represents the concept of the year where weeks start on a fixed day-of-week, such as Monday and each week belongs to exactly one year. This field is typically used with dayOfWeek() and weekOfWeekBasedYear().

Week one(1) is the week starting on the getFirstDayOfWeek() where there are at least getMinimalDaysInFirstWeek() days in the year. Thus, week one may start before the start of the year. If the first week starts after the start of the year then the period before is in the last week of the previous year.

This field can be used with any calendar system.

In the resolving phase of parsing, a date can be created from a week-based-year, week-of-year and day-of-week.

In strict mode, all three fields are validated against their range of valid values. The week-of-year field is validated to ensure that the resulting week-based-year is the week-based-year requested.

In smart mode, all three fields are validated against their range of valid values. The week-of-week-based-year field is validated from 1 to 53, meaning that the resulting date can be in the following week-based-year to that specified.

In lenient mode, the year and day-of-week are validated against the range of valid values. The resulting date is calculated equivalent to the following three stage approach. First, create a date on the first day of the first week in the requested week-based-year. Then take the week-of-week-based-year, subtract one, and add the amount in weeks to the date. Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-based-year, not null - java.time.temporal.TemporalField

Returns a field to access the year of a week-based-year based on this WeekFields.

 This represents the concept of the year where weeks start on a fixed day-of-week,
 such as Monday and each week belongs to exactly one year.
 This field is typically used with dayOfWeek() and
 weekOfWeekBasedYear().

 Week one(1) is the week starting on the getFirstDayOfWeek()
 where there are at least getMinimalDaysInFirstWeek() days in the year.
 Thus, week one may start before the start of the year.
 If the first week starts after the start of the year then the period before
 is in the last week of the previous year.

 This field can be used with any calendar system.

 In the resolving phase of parsing, a date can be created from a week-based-year,
 week-of-year and day-of-week.

 In strict mode, all three fields are
 validated against their range of valid values. The week-of-year field
 is validated to ensure that the resulting week-based-year is the
 week-based-year requested.

 In smart mode, all three fields are
 validated against their range of valid values. The week-of-week-based-year field
 is validated from 1 to 53, meaning that the resulting date can be in the
 following week-based-year to that specified.

 In lenient mode, the year and day-of-week
 are validated against the range of valid values. The resulting date is calculated
 equivalent to the following three stage approach.
 First, create a date on the first day of the first week in the requested week-based-year.
 Then take the week-of-week-based-year, subtract one, and add the amount in weeks to the date.
 Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-based-year, not null - `java.time.temporal.TemporalField`
raw docstring

week-of-monthclj

(week-of-month this)

Returns a field to access the week of month based on this WeekFields.

This represents the concept of the count of weeks within the month where weeks start on a fixed day-of-week, such as Monday. This field is typically used with dayOfWeek().

Week one (1) is the week starting on the getFirstDayOfWeek() where there are at least getMinimalDaysInFirstWeek() days in the month. Thus, week one may start up to minDays days before the start of the month. If the first week starts after the start of the month then the period before is week zero (0).

For example:

  • if the 1st day of the month is a Monday, week one starts on the 1st and there is no week zero
  • if the 2nd day of the month is a Monday, week one starts on the 2nd and the 1st is in week zero
  • if the 4th day of the month is a Monday, week one starts on the 4th and the 1st to 3rd is in week zero
  • if the 5th day of the month is a Monday, week two starts on the 5th and the 1st to 4th is in week one

This field can be used with any calendar system.

In the resolving phase of parsing, a date can be created from a year, week-of-month, month-of-year and day-of-week.

In strict mode, all four fields are validated against their range of valid values. The week-of-month field is validated to ensure that the resulting month is the month requested.

In smart mode, all four fields are validated against their range of valid values. The week-of-month field is validated from 0 to 6, meaning that the resulting date can be in a different month to that specified.

In lenient mode, the year and day-of-week are validated against the range of valid values. The resulting date is calculated equivalent to the following four stage approach. First, create a date on the first day of the first week of January in the requested year. Then take the month-of-year, subtract one, and add the amount in months to the date. Then take the week-of-month, subtract one, and add the amount in weeks to the date. Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-month, not null - java.time.temporal.TemporalField

Returns a field to access the week of month based on this WeekFields.

 This represents the concept of the count of weeks within the month where weeks
 start on a fixed day-of-week, such as Monday.
 This field is typically used with dayOfWeek().

 Week one (1) is the week starting on the getFirstDayOfWeek()
 where there are at least getMinimalDaysInFirstWeek() days in the month.
 Thus, week one may start up to minDays days before the start of the month.
 If the first week starts after the start of the month then the period before is week zero (0).

 For example:
 - if the 1st day of the month is a Monday, week one starts on the 1st and there is no week zero
 - if the 2nd day of the month is a Monday, week one starts on the 2nd and the 1st is in week zero
 - if the 4th day of the month is a Monday, week one starts on the 4th and the 1st to 3rd is in week zero
 - if the 5th day of the month is a Monday, week two starts on the 5th and the 1st to 4th is in week one

 This field can be used with any calendar system.

 In the resolving phase of parsing, a date can be created from a year,
 week-of-month, month-of-year and day-of-week.

 In strict mode, all four fields are
 validated against their range of valid values. The week-of-month field
 is validated to ensure that the resulting month is the month requested.

 In smart mode, all four fields are
 validated against their range of valid values. The week-of-month field
 is validated from 0 to 6, meaning that the resulting date can be in a
 different month to that specified.

 In lenient mode, the year and day-of-week
 are validated against the range of valid values. The resulting date is calculated
 equivalent to the following four stage approach.
 First, create a date on the first day of the first week of January in the requested year.
 Then take the month-of-year, subtract one, and add the amount in months to the date.
 Then take the week-of-month, subtract one, and add the amount in weeks to the date.
 Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-month, not null - `java.time.temporal.TemporalField`
raw docstring

week-of-week-based-yearclj

(week-of-week-based-year this)

Returns a field to access the week of a week-based-year based on this WeekFields.

This represents the concept of the count of weeks within the year where weeks start on a fixed day-of-week, such as Monday and each week belongs to exactly one year. This field is typically used with dayOfWeek() and weekBasedYear().

Week one(1) is the week starting on the getFirstDayOfWeek() where there are at least getMinimalDaysInFirstWeek() days in the year. If the first week starts after the start of the year then the period before is in the last week of the previous year.

For example:

  • if the 1st day of the year is a Monday, week one starts on the 1st
  • if the 2nd day of the year is a Monday, week one starts on the 2nd and the 1st is in the last week of the previous year
  • if the 4th day of the year is a Monday, week one starts on the 4th and the 1st to 3rd is in the last week of the previous year
  • if the 5th day of the year is a Monday, week two starts on the 5th and the 1st to 4th is in week one

This field can be used with any calendar system.

In the resolving phase of parsing, a date can be created from a week-based-year, week-of-year and day-of-week.

In strict mode, all three fields are validated against their range of valid values. The week-of-year field is validated to ensure that the resulting week-based-year is the week-based-year requested.

In smart mode, all three fields are validated against their range of valid values. The week-of-week-based-year field is validated from 1 to 53, meaning that the resulting date can be in the following week-based-year to that specified.

In lenient mode, the year and day-of-week are validated against the range of valid values. The resulting date is calculated equivalent to the following three stage approach. First, create a date on the first day of the first week in the requested week-based-year. Then take the week-of-week-based-year, subtract one, and add the amount in weeks to the date. Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-week-based-year, not null - java.time.temporal.TemporalField

Returns a field to access the week of a week-based-year based on this WeekFields.

 This represents the concept of the count of weeks within the year where weeks
 start on a fixed day-of-week, such as Monday and each week belongs to exactly one year.
 This field is typically used with dayOfWeek() and
 weekBasedYear().

 Week one(1) is the week starting on the getFirstDayOfWeek()
 where there are at least getMinimalDaysInFirstWeek() days in the year.
 If the first week starts after the start of the year then the period before
 is in the last week of the previous year.

 For example:
 - if the 1st day of the year is a Monday, week one starts on the 1st
 - if the 2nd day of the year is a Monday, week one starts on the 2nd and
   the 1st is in the last week of the previous year
 - if the 4th day of the year is a Monday, week one starts on the 4th and
   the 1st to 3rd is in the last week of the previous year
 - if the 5th day of the year is a Monday, week two starts on the 5th and
   the 1st to 4th is in week one

 This field can be used with any calendar system.

 In the resolving phase of parsing, a date can be created from a week-based-year,
 week-of-year and day-of-week.

 In strict mode, all three fields are
 validated against their range of valid values. The week-of-year field
 is validated to ensure that the resulting week-based-year is the
 week-based-year requested.

 In smart mode, all three fields are
 validated against their range of valid values. The week-of-week-based-year field
 is validated from 1 to 53, meaning that the resulting date can be in the
 following week-based-year to that specified.

 In lenient mode, the year and day-of-week
 are validated against the range of valid values. The resulting date is calculated
 equivalent to the following three stage approach.
 First, create a date on the first day of the first week in the requested week-based-year.
 Then take the week-of-week-based-year, subtract one, and add the amount in weeks to the date.
 Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-week-based-year, not null - `java.time.temporal.TemporalField`
raw docstring

week-of-yearclj

(week-of-year this)

Returns a field to access the week of year based on this WeekFields.

This represents the concept of the count of weeks within the year where weeks start on a fixed day-of-week, such as Monday. This field is typically used with dayOfWeek().

Week one(1) is the week starting on the getFirstDayOfWeek() where there are at least getMinimalDaysInFirstWeek() days in the year. Thus, week one may start up to minDays days before the start of the year. If the first week starts after the start of the year then the period before is week zero (0).

For example:

  • if the 1st day of the year is a Monday, week one starts on the 1st and there is no week zero
  • if the 2nd day of the year is a Monday, week one starts on the 2nd and the 1st is in week zero
  • if the 4th day of the year is a Monday, week one starts on the 4th and the 1st to 3rd is in week zero
  • if the 5th day of the year is a Monday, week two starts on the 5th and the 1st to 4th is in week one

This field can be used with any calendar system.

In the resolving phase of parsing, a date can be created from a year, week-of-year and day-of-week.

In strict mode, all three fields are validated against their range of valid values. The week-of-year field is validated to ensure that the resulting year is the year requested.

In smart mode, all three fields are validated against their range of valid values. The week-of-year field is validated from 0 to 54, meaning that the resulting date can be in a different year to that specified.

In lenient mode, the year and day-of-week are validated against the range of valid values. The resulting date is calculated equivalent to the following three stage approach. First, create a date on the first day of the first week in the requested year. Then take the week-of-year, subtract one, and add the amount in weeks to the date. Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-year, not null - java.time.temporal.TemporalField

Returns a field to access the week of year based on this WeekFields.

 This represents the concept of the count of weeks within the year where weeks
 start on a fixed day-of-week, such as Monday.
 This field is typically used with dayOfWeek().

 Week one(1) is the week starting on the getFirstDayOfWeek()
 where there are at least getMinimalDaysInFirstWeek() days in the year.
 Thus, week one may start up to minDays days before the start of the year.
 If the first week starts after the start of the year then the period before is week zero (0).

 For example:
 - if the 1st day of the year is a Monday, week one starts on the 1st and there is no week zero
 - if the 2nd day of the year is a Monday, week one starts on the 2nd and the 1st is in week zero
 - if the 4th day of the year is a Monday, week one starts on the 4th and the 1st to 3rd is in week zero
 - if the 5th day of the year is a Monday, week two starts on the 5th and the 1st to 4th is in week one

 This field can be used with any calendar system.

 In the resolving phase of parsing, a date can be created from a year,
 week-of-year and day-of-week.

 In strict mode, all three fields are
 validated against their range of valid values. The week-of-year field
 is validated to ensure that the resulting year is the year requested.

 In smart mode, all three fields are
 validated against their range of valid values. The week-of-year field
 is validated from 0 to 54, meaning that the resulting date can be in a
 different year to that specified.

 In lenient mode, the year and day-of-week
 are validated against the range of valid values. The resulting date is calculated
 equivalent to the following three stage approach.
 First, create a date on the first day of the first week in the requested year.
 Then take the week-of-year, subtract one, and add the amount in weeks to the date.
 Finally, adjust to the correct day-of-week within the localized week.

returns: a field providing access to the week-of-year, not null - `java.time.temporal.TemporalField`
raw docstring

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close