Klasse Dates

Datum und Uhrzeit als JavaScript-Date-Werte: sie erstellen, ihre Teile lesen und setzen und sie als Text formatieren. Monate zählen ab 0 (Januar ist 0, Dezember 11) und Wochentage ab 0 (Sonntag); Tage des Monats zählen ab 1. Jeder Setter gibt ein neues Datum zurück und lässt das übergebene unverändert. Für die meisten Operationen gibt es Varianten für Ortszeit und UTC.

Konstruktoren

constructor

new Dates(): Bit.Dates
Rückgabewert Bit.Dates

convert

toDateString

toDateString(inputs: DateDto): string
Formatiert den Datumsteil als Text, ohne die Uhrzeit, in der lokalen Zeitzone.

Beispiel: 15. Januar 2024 um 14:30 -> 'Mon Jan 15 2024'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Das Datum als Text wie 'Mon Jan 15 2024'
- Definiert in bitbybit-docs.d.ts:53094

toISOString

toISOString(inputs: DateDto): string
Formatiert Datum und Uhrzeit in der ISO-8601-Form, die für den Datenaustausch verwendet wird, immer in UTC.

Beispiel: 15. Januar 2024 um 14:30 -> '2024-01-15T14:30:45.000Z'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Das Datum als Text wie '2024-01-15T14:30:45.000Z'
- Definiert in bitbybit-docs.d.ts:53105

toJSON

toJSON(inputs: DateDto): string
Formatiert das Datum so, wie es in JSON erscheint, was die ISO-8601-Form in UTC ist.

Beispiel: 15. Januar 2024 um 14:30 -> '2024-01-15T14:30:00.000Z'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Das Datum als Text wie '2024-01-15T14:30:00.000Z'
- Definiert in bitbybit-docs.d.ts:53116

toString

toString(inputs: DateDto): string
Formatiert das vollständige Datum und die Uhrzeit als Text in der lokalen Zeitzone, mit dem Zonenversatz.

Beispiel: 15. Januar 2024 um 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Datum und Uhrzeit als Text
- Definiert in bitbybit-docs.d.ts:53127

toTimeString

toTimeString(inputs: DateDto): string
Formatiert den Uhrzeitteil als Text, ohne das Datum, in der lokalen Zeitzone mit dem Zonenversatz.

Beispiel: 15. Januar 2024 um 14:30 -> '14:30:45 GMT+0000'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Die Uhrzeit als Text wie '14:30:45 GMT+0000'
- Definiert in bitbybit-docs.d.ts:53138

toUTCString

toUTCString(inputs: DateDto): string
Formatiert Datum und Uhrzeit als Text in UTC.

Beispiel: 15. Januar 2024 um 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert string
Datum und Uhrzeit als UTC-Text
- Definiert in bitbybit-docs.d.ts:53149

create

now

now(): Date
Liefert das aktuelle Datum und die aktuelle Uhrzeit im Moment des Aufrufs.

Rückgabewert Date
Das aktuelle Datum und die aktuelle Uhrzeit
- Definiert in bitbybit-docs.d.ts:53157

createDate

createDate(inputs: CreateDateDto): Date
Erzeugt ein Datum aus seinen Teilen, gelesen in der lokalen Zeitzone.

Der Monat zählt ab 0: 0 ist Januar, 11 Dezember. Ein Teil außerhalb seines Bereichs läuft über, sodass Tag 32 des Januars zum ersten Februar wird. Beispiel: Jahr 2024, Monat 0, Tag 15, Stunden 14, Minuten 30 -> 15. Januar 2024 um 14:30 lokaler Zeit
Parameter
- inputs: CreateDateDto
  Jahr, Monat, Tag, Stunden, Minuten, Sekunden und Millisekunden
Rückgabewert Date
Das Datum
Example
```
const date = bitbybit.dates.createDate({ year: 2024, month: 0, day: 15, hours: 14, minutes: 30, seconds: 0, milliseconds: 0 });
```
- Definiert in bitbybit-docs.d.ts:53175

createDateUTC

createDateUTC(inputs: CreateDateDto): Date
Erzeugt ein Datum aus seinen Teilen, gelesen als UTC, sodass die lokale Zeitzone keine Rolle spielt.

Der Monat zählt ab 0: 0 ist Januar, 11 Dezember. Ein Teil außerhalb seines Bereichs läuft über. Beispiel: Jahr 2024, Monat 0, Tag 15 -> 15. Januar 2024 um 00:00 UTC
Parameter
- inputs: CreateDateDto
  Jahr, Monat, Tag, Stunden, Minuten, Sekunden und Millisekunden
Rückgabewert Date
Das Datum
Example
```
const date = bitbybit.dates.createDateUTC({ year: 2024, month: 0, day: 15, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 });
```
- Definiert in bitbybit-docs.d.ts:53191

createFromUnixTimeStamp

createFromUnixTimeStamp(inputs: CreateFromUnixTimeStampDto): Date
Erzeugt ein Datum aus einem Unix-Zeitstempel: der Anzahl der Millisekunden seit dem 1. Januar 1970 um 00:00 UTC.

Beispiel: 1705329000000 -> 15. Januar 2024 um 14:30 UTC
Parameter
- inputs: CreateFromUnixTimeStampDto
  Der Zeitstempel in Millisekunden
Rückgabewert Date
Das Datum
Example
```
const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });
```
- Definiert in bitbybit-docs.d.ts:53207

get

getDayOfMonth

getDayOfMonth(inputs: DateDto): number
Liest den Tag des Monats, von 1 bis 31, in der lokalen Zeitzone.

Beispiel: 15. Januar 2024 -> 15
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Tag des Monats
- Definiert in bitbybit-docs.d.ts:53236

getWeekday

getWeekday(inputs: DateDto): number
Liest den Wochentag in der lokalen Zeitzone: 0 ist Sonntag, 6 Samstag.

Beispiel: 15. Januar 2024 -> 1, ein Montag
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Wochentag von 0 bis 6
- Definiert in bitbybit-docs.d.ts:53247

getYear

getYear(inputs: DateDto): number
Liest das volle Jahr in der lokalen Zeitzone.

Beispiel: 15. Januar 2024 -> 2024
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Das Jahr
- Definiert in bitbybit-docs.d.ts:53258

getMonth

getMonth(inputs: DateDto): number
Liest den Monat in der lokalen Zeitzone, gezählt ab 0: 0 ist Januar, 11 Dezember.

Beispiel: 15. Januar 2024 -> 0
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Monat von 0 bis 11
- Definiert in bitbybit-docs.d.ts:53269

getHours

getHours(inputs: DateDto): number
Liest die Stunde, von 0 bis 23, in der lokalen Zeitzone.

Beispiel: 14:30 -> 14
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Stunde
- Definiert in bitbybit-docs.d.ts:53280

getMinutes

getMinutes(inputs: DateDto): number
Liest die Minuten, von 0 bis 59, in der lokalen Zeitzone.

Beispiel: 14:30 -> 30
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Minuten
- Definiert in bitbybit-docs.d.ts:53291

getSeconds

getSeconds(inputs: DateDto): number
Liest die Sekunden, von 0 bis 59, in der lokalen Zeitzone.

Beispiel: 14:30:45 -> 45
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Sekunden
- Definiert in bitbybit-docs.d.ts:53302

getMilliseconds

getMilliseconds(inputs: DateDto): number
Liest die Millisekunden, von 0 bis 999, in der lokalen Zeitzone.

Beispiel: 14:30:45.123 -> 123
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Millisekunden
- Definiert in bitbybit-docs.d.ts:53313

getTime

getTime(inputs: DateDto): number
Liefert das Datum als Unix-Zeitstempel: die Millisekunden seit dem 1. Januar 1970 um 00:00 UTC.

Beispiel: 15. Januar 2024 um 14:30 UTC -> 1705329000000
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Zeitstempel in Millisekunden
- Definiert in bitbybit-docs.d.ts:53324

getUTCYear

getUTCYear(inputs: DateDto): number
Liest das volle Jahr in UTC.

Beispiel: 15. Januar 2024 -> 2024
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Das Jahr
- Definiert in bitbybit-docs.d.ts:53335

getUTCMonth

getUTCMonth(inputs: DateDto): number
Liest den Monat in UTC, gezählt ab 0: 0 ist Januar, 11 Dezember.

Beispiel: 15. Januar 2024 -> 0
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Monat von 0 bis 11
- Definiert in bitbybit-docs.d.ts:53346

getUTCDay

getUTCDay(inputs: DateDto): number
Liest den Tag des Monats, von 1 bis 31, in UTC.

Beispiel: 15. Januar 2024 -> 15
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Der Tag des Monats
- Definiert in bitbybit-docs.d.ts:53357

getUTCHours

getUTCHours(inputs: DateDto): number
Liest die Stunde, von 0 bis 23, in UTC.

Beispiel: 14:00 UTC -> 14
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Stunde
- Definiert in bitbybit-docs.d.ts:53368

getUTCMinutes

getUTCMinutes(inputs: DateDto): number
Liest die Minuten, von 0 bis 59, in UTC.

Beispiel: 14:30 UTC -> 30
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Minuten
- Definiert in bitbybit-docs.d.ts:53379

getUTCSeconds

getUTCSeconds(inputs: DateDto): number
Liest die Sekunden, von 0 bis 59, in UTC.

Beispiel: 14:30:45 UTC -> 45
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Sekunden
- Definiert in bitbybit-docs.d.ts:53390

getUTCMilliseconds

getUTCMilliseconds(inputs: DateDto): number
Liest die Millisekunden, von 0 bis 999, in UTC.

Beispiel: 14:30:45.123 UTC -> 123
Parameter
- inputs: DateDto
  Das Datum
Rückgabewert number
Die Millisekunden
- Definiert in bitbybit-docs.d.ts:53401

parse

parseDate

parseDate(inputs: DateStringDto): number
Liest ein als Text geschriebenes Datum und liefert seinen Unix-Zeitstempel, die Millisekunden seit dem 1. Januar 1970 um 00:00 UTC.

ISO-8601-Text wie '2024-01-15' oder '2024-01-15T14:30:00Z' wird zuverlässig gelesen; Text, der nicht gelesen werden kann, ergibt NaN. Beispiel: '2024-01-15' -> 1705276800000
Parameter
- inputs: DateStringDto
  Das Datum als Text
Rückgabewert number
Der Zeitstempel in Millisekunden oder NaN, wenn der Text kein Datum ist
Example
```
const stamp = bitbybit.dates.parseDate({ dateString: "2024-01-15T14:30:00Z" });
```
- Definiert in bitbybit-docs.d.ts:53225

set

setYear

setYear(inputs: DateYearDto): Date
Erstellt eine Kopie des Datums mit einem anderen Jahr, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Jahr 2025 -> 15. Januar 2025
Parameter
- inputs: DateYearDto
  Das Datum und das Jahr
Rückgabewert Date
Ein neues Datum mit geändertem Jahr
Example
```
const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Definiert in bitbybit-docs.d.ts:53417

setMonth

setMonth(inputs: DateMonthDto): Date
Erstellt eine Kopie des Datums mit einem anderen Monat, in der lokalen Zeitzone; Monate zählen ab 0. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Monat 5 -> 15. Juni 2024
Parameter
- inputs: DateMonthDto
  Das Datum und der Monat von 0 bis 11
Rückgabewert Date
Ein neues Datum mit geändertem Monat
Example
```
const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Definiert in bitbybit-docs.d.ts:53433

setDayOfMonth

setDayOfMonth(inputs: DateDayDto): Date
Erstellt eine Kopie des Datums mit einem anderen Tag des Monats, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Tag 20 -> 20. Januar 2024
Parameter
- inputs: DateDayDto
  Das Datum und der Tag von 1 bis 31
Rückgabewert Date
Ein neues Datum mit geändertem Tag
Example
```
const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });
```
- Definiert in bitbybit-docs.d.ts:53449

setHours

setHours(inputs: DateHoursDto): Date
Erstellt eine Kopie des Datums mit einer anderen Stunde, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30 mit Stunden 9 -> 09:30
Parameter
- inputs: DateHoursDto
  Das Datum und die Stunde von 0 bis 23
Rückgabewert Date
Ein neues Datum mit geänderter Stunde
Example
```
const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Definiert in bitbybit-docs.d.ts:53465

setMinutes

setMinutes(inputs: DateMinutesDto): Date
Erstellt eine Kopie des Datums mit anderen Minuten, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30 mit Minuten 45 -> 14:45
Parameter
- inputs: DateMinutesDto
  Das Datum und die Minuten von 0 bis 59
Rückgabewert Date
Ein neues Datum mit geänderten Minuten
Example
```
const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Definiert in bitbybit-docs.d.ts:53481

setSeconds

setSeconds(inputs: DateSecondsDto): Date
Erstellt eine Kopie des Datums mit anderen Sekunden, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30:00 mit Sekunden 30 -> 14:30:30
Parameter
- inputs: DateSecondsDto
  Das Datum und die Sekunden von 0 bis 59
Rückgabewert Date
Ein neues Datum mit geänderten Sekunden
Example
```
const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Definiert in bitbybit-docs.d.ts:53497

setMilliseconds

setMilliseconds(inputs: DateMillisecondsDto): Date
Erstellt eine Kopie des Datums mit anderen Millisekunden, in der lokalen Zeitzone. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30:00.000 mit Millisekunden 500 -> 14:30:00.500
Parameter
- inputs: DateMillisecondsDto
  Das Datum und die Millisekunden von 0 bis 999
Rückgabewert Date
Ein neues Datum mit geänderten Millisekunden
Example
```
const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
```
- Definiert in bitbybit-docs.d.ts:53513

setTime

setTime(inputs: DateTimeDto): Date
Erstellt eine Kopie des Datums, verschoben auf einen Unix-Zeitstempel, die Millisekunden seit dem 1. Januar 1970 um 00:00 UTC. Das übergebene Datum wird nicht geändert.

Beispiel: ein beliebiges Datum mit Zeit 0 -> 1. Januar 1970 um 00:00 UTC
Parameter
- inputs: DateTimeDto
  Das Datum und der Zeitstempel in Millisekunden
Rückgabewert Date
Ein neues Datum mit geändertem Zeitstempel
Example
```
const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });
```
- Definiert in bitbybit-docs.d.ts:53529

setUTCYear

setUTCYear(inputs: DateYearDto): Date
Erstellt eine Kopie des Datums mit einem anderen Jahr, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Jahr 2025 -> 15. Januar 2025
Parameter
- inputs: DateYearDto
  Das Datum und das Jahr
Rückgabewert Date
Ein neues Datum mit geändertem Jahr
Example
```
const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Definiert in bitbybit-docs.d.ts:53544

setUTCMonth

setUTCMonth(inputs: DateMonthDto): Date
Erstellt eine Kopie des Datums mit einem anderen Monat, in UTC; Monate zählen ab 0. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Monat 5 -> 15. Juni 2024
Parameter
- inputs: DateMonthDto
  Das Datum und der Monat von 0 bis 11
Rückgabewert Date
Ein neues Datum mit geändertem Monat
Example
```
const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Definiert in bitbybit-docs.d.ts:53560

setUTCDay

setUTCDay(inputs: DateDayDto): Date
Erstellt eine Kopie des Datums mit einem anderen Tag des Monats, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 15. Januar 2024 mit Tag 20 -> 20. Januar 2024
Parameter
- inputs: DateDayDto
  Das Datum und der Tag von 1 bis 31
Rückgabewert Date
Ein neues Datum mit geändertem Tag
Example
```
const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });
```
- Definiert in bitbybit-docs.d.ts:53576

setUTCHours

setUTCHours(inputs: DateHoursDto): Date
Erstellt eine Kopie des Datums mit einer anderen Stunde, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30 UTC mit Stunden 9 -> 09:30 UTC
Parameter
- inputs: DateHoursDto
  Das Datum und die Stunde von 0 bis 23
Rückgabewert Date
Ein neues Datum mit geänderter Stunde
Example
```
const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Definiert in bitbybit-docs.d.ts:53591

setUTCMinutes

setUTCMinutes(inputs: DateMinutesDto): Date
Erstellt eine Kopie des Datums mit anderen Minuten, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30 UTC mit Minuten 45 -> 14:45 UTC
Parameter
- inputs: DateMinutesDto
  Das Datum und die Minuten von 0 bis 59
Rückgabewert Date
Ein neues Datum mit geänderten Minuten
Example
```
const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Definiert in bitbybit-docs.d.ts:53606

setUTCSeconds

setUTCSeconds(inputs: DateSecondsDto): Date
Erstellt eine Kopie des Datums mit anderen Sekunden, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30:00 UTC mit Sekunden 30 -> 14:30:30 UTC
Parameter
- inputs: DateSecondsDto
  Das Datum und die Sekunden von 0 bis 59
Rückgabewert Date
Ein neues Datum mit geänderten Sekunden
Example
```
const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Definiert in bitbybit-docs.d.ts:53621

setUTCMilliseconds

setUTCMilliseconds(inputs: DateMillisecondsDto): Date
Erstellt eine Kopie des Datums mit anderen Millisekunden, in UTC. Das übergebene Datum wird nicht geändert.

Beispiel: 14:30:00.000 UTC mit Millisekunden 500 -> 14:30:00.500 UTC
Parameter
- inputs: DateMillisecondsDto
  Das Datum und die Millisekunden von 0 bis 999
Rückgabewert Date
Ein neues Datum mit geänderten Millisekunden
Example
```
const changed = bitbybit.dates.setUTCMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
```
- Definiert in bitbybit-docs.d.ts:53636

Klasse Dates

Index

Konstruktoren

convert

create

get

parse

set

Konstruktoren

constructor

Rückgabewert Bit.Dates

convert

toDateString

Parameter

Rückgabewert string

toISOString

Parameter

Rückgabewert string

toJSON

Parameter

Rückgabewert string

toString

Parameter

Rückgabewert string

toTimeString

Parameter

Rückgabewert string

toUTCString

Parameter

Rückgabewert string

create

now

Rückgabewert Date

createDate

Parameter

Rückgabewert Date

Example

createDateUTC

Parameter

Rückgabewert Date

Example

createFromUnixTimeStamp

Parameter

Rückgabewert Date

Example

get

getDayOfMonth

Parameter

Rückgabewert number

getWeekday

Parameter

Rückgabewert number

getYear

Parameter

Rückgabewert number

getMonth

Parameter

Rückgabewert number

getHours

Parameter

Rückgabewert number

getMinutes

Parameter

Rückgabewert number

getSeconds

Parameter

Rückgabewert number

getMilliseconds

Parameter

Rückgabewert number

getTime

Parameter

Rückgabewert number

getUTCYear

Parameter

Rückgabewert number

getUTCMonth

Parameter

Rückgabewert number

getUTCDay