> For the complete documentation index, see [llms.txt](https://mind-expression-docs.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mind-expression-docs.gitbook.io/home/how-to-guides/intelligent-process/package-kernel-dates.md).

# Package: Kernel-Dates

## Class: Date

### Introduction

**Environment: `container`**

A Date is an object which holds a specific point in time, from year to seconds.

Currently, there are hard-coded strings for days of the week (Monday - Sunday) as well as months in a year (January - December), and also their abbreviations.

Both days of week and months in year are indexed starting with 1 (Monday and January).

Most of the available functions use the Date class instead of a Date instance.

For example:

```smalltalk
dv := Date daysInYear: 2024. "dv = 366"

dv := Date daysInMonth: 'February' forYear: 2020. "dv = 29"
dv := Date daysInMonth: 'October' forYear: 2022. "dv = 31"

ds := ':'.
dv := { 3. 6. 9 } do: [ :each | ds := ds + (Date shortNameOfMonth: each) + ':' ].
ds = ':Mar:Jun:Sep:'. "true"
```

### Class Method

#### Category: accessing

* **`abbreviationOfDay:`** - Answer the abbreviated name of the day of week corresponding to the given index (1=Mon, 7=Sun based).

  For example:

  ```smalltalk
  dv := Date abbreviationOfDay: 2. "dv = 'Tue'"
  ```
* **`dayOfWeek:`** - Answer the index of the day of week corresponding to the given name (1=Monday, 7=Sunday based).

  For example:

  ```smalltalk
  dv := Date dayOfWeek: 'Monday'. "dv = 1"
  ```
* **`daysInMonth:forYear:`** - Answer the number of days in the given (named) month for the given year.

  For example:

  ```smalltalk
  dv := Date daysInMonth: 'February' forYear: 2024. "dv = 29"
  dv := Date daysInMonth: 'December' forYear: 2024. "dv = 31"
  ```
* **`daysInYear:`** - Answer the number of days in the given year.

  For example:

  ```smalltalk
  dv := Date daysInYear: 2020. "dv = 366"
  dv := Date daysInYear: 2021. "dv = 365"
  ```
* **`indexOfMonth:`** - Answer the index of the month corresponding to the given name (1=January based).

  For example:

  ```smalltalk
  dv := Date indexOfMonth: 'February'. "dv = 2"
  ```
* **`nameOfDay:`** - Answer the name of the day of week corresponding to the given index (1=Monday, 7=Sunday based).

  For example:

  ```smalltalk
  dv := Date nameOfDay: 4. "dv = 'Thursday'"
  ```
* **`nameOfMonth:`** - Answer the name of the month corresponding to the given index (1=January based).

  For example:

  ```smalltalk
  dv := Date nameOfMonth: 4. "dv = 'April'"
  ```
* **`shortNameOfMonth:`** - Answer the name of the month corresponding to the given index (1=January based).

  For example:

  ```smalltalk
  dv := Date shortNameOfMonth: 4. "dv = 'Apr'"
  ```

#### Category: instance creation

* **`year:day:hour:minute:second:`** - Answer a Date denoting the d-th day of the given year.

  For example:

  ```smalltalk
  dv := Date year: 2023 day: 32 hour: 1 minute: 0 second: 0.
  "dv = @2023-02-01T01:00:00.000000Z"
  ```
* **`year:month:day:hour:minute:second:`** - Answer a Date denoting the d-th day of the given (as a number) month and year.

  For example:

  ```smalltalk
  dv := Date year: 2023 month: 2 day: 1 hour: 1 minute: 0 second: 0.
  "dv = @2023-02-01T01:00:00.000000Z"
  ```