Class Dates

Fechas y horas como valores Date de JavaScript: crearlas, leer y establecer sus partes, y formatearlas como texto. Los meses cuentan desde 0 (enero es 0, diciembre 11) y los días de la semana desde 0 (domingo); los días del mes cuentan desde 1. Cada setter devuelve una fecha nueva y deja la dada sin cambios. Existen variantes en hora local y UTC para la mayoría de las operaciones.

Constructors

constructor

new Dates(): Bit.Dates
Returns Bit.Dates

convert

toDateString

toDateString(inputs: DateDto): string
Formatea la parte de fecha como texto, sin la hora, en la zona horaria local.

Ejemplo: 15 de enero de 2024 a las 14:30 -> 'Mon Jan 15 2024'
Parameters
- inputs: DateDto
  La fecha
Returns string
La fecha como texto tal como 'Mon Jan 15 2024'
- Defined in bitbybit-docs.d.ts:53094

toISOString

toISOString(inputs: DateDto): string
Formatea la fecha y la hora en la forma ISO 8601 usada para el intercambio de datos, siempre en UTC.

Ejemplo: 15 de enero de 2024 a las 14:30 -> '2024-01-15T14:30:45.000Z'
Parameters
- inputs: DateDto
  La fecha
Returns string
La fecha como texto tal como '2024-01-15T14:30:45.000Z'
- Defined in bitbybit-docs.d.ts:53105

toJSON

toJSON(inputs: DateDto): string
Formatea la fecha tal como aparece dentro de un JSON, que es la forma ISO 8601 en UTC.

Ejemplo: 15 de enero de 2024 a las 14:30 -> '2024-01-15T14:30:00.000Z'
Parameters
- inputs: DateDto
  La fecha
Returns string
La fecha como texto tal como '2024-01-15T14:30:00.000Z'
- Defined in bitbybit-docs.d.ts:53116

toString

toString(inputs: DateDto): string
Formatea la fecha y la hora completas como texto en la zona horaria local, con el desfase de zona.

Ejemplo: 15 de enero de 2024 a las 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'
Parameters
- inputs: DateDto
  La fecha
Returns string
La fecha y la hora como texto
- Defined in bitbybit-docs.d.ts:53127

toTimeString

toTimeString(inputs: DateDto): string
Formatea la parte de hora como texto, sin la fecha, en la zona horaria local con el desfase de zona.

Ejemplo: 15 de enero de 2024 a las 14:30 -> '14:30:45 GMT+0000'
Parameters
- inputs: DateDto
  La fecha
Returns string
La hora como texto tal como '14:30:45 GMT+0000'
- Defined in bitbybit-docs.d.ts:53138

toUTCString

toUTCString(inputs: DateDto): string
Formatea la fecha y la hora como texto en UTC.

Ejemplo: 15 de enero de 2024 a las 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'
Parameters
- inputs: DateDto
  La fecha
Returns string
La fecha y la hora como texto UTC
- Defined in bitbybit-docs.d.ts:53149

create

now

now(): Date
Da la fecha y la hora actuales en el momento de la llamada.

Returns Date
La fecha y la hora actuales
- Defined in bitbybit-docs.d.ts:53157

createDate

createDate(inputs: CreateDateDto): Date
Construye una fecha a partir de sus partes, leídas en la zona horaria local.

El mes cuenta desde 0: 0 es enero, 11 diciembre. Una parte fuera de su rango se desborda, así que el día 32 de enero se convierte en el primero de febrero. Ejemplo: año 2024, mes 0, día 15, horas 14, minutos 30 -> 15 de enero de 2024 a las 14:30 hora local
Parameters
- inputs: CreateDateDto
  El año, el mes, el día, las horas, los minutos, los segundos y los milisegundos
Returns Date
La fecha
Example
```
const date = bitbybit.dates.createDate({ year: 2024, month: 0, day: 15, hours: 14, minutes: 30, seconds: 0, milliseconds: 0 });
```
- Defined in bitbybit-docs.d.ts:53175

createDateUTC

createDateUTC(inputs: CreateDateDto): Date
Construye una fecha a partir de sus partes, leídas como UTC de modo que la zona horaria local no interviene.

El mes cuenta desde 0: 0 es enero, 11 diciembre. Una parte fuera de su rango se desborda. Ejemplo: año 2024, mes 0, día 15 -> 15 de enero de 2024 a las 00:00 UTC
Parameters
- inputs: CreateDateDto
  El año, el mes, el día, las horas, los minutos, los segundos y los milisegundos
Returns Date
La fecha
Example
```
const date = bitbybit.dates.createDateUTC({ year: 2024, month: 0, day: 15, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 });
```
- Defined in bitbybit-docs.d.ts:53191

createFromUnixTimeStamp

createFromUnixTimeStamp(inputs: CreateFromUnixTimeStampDto): Date
Construye una fecha a partir de una marca de tiempo Unix: el número de milisegundos desde el 1 de enero de 1970 a las 00:00 UTC.

Ejemplo: 1705329000000 -> 15 de enero de 2024 a las 14:30 UTC
Parameters
- inputs: CreateFromUnixTimeStampDto
  La marca de tiempo en milisegundos
Returns Date
La fecha
Example
```
const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });
```
- Defined in bitbybit-docs.d.ts:53207

get

getDayOfMonth

getDayOfMonth(inputs: DateDto): number
Lee el día del mes, de 1 a 31, en la zona horaria local.

Ejemplo: 15 de enero de 2024 -> 15
Parameters
- inputs: DateDto
  La fecha
Returns number
El día del mes
- Defined in bitbybit-docs.d.ts:53236

getWeekday

getWeekday(inputs: DateDto): number
Lee el día de la semana en la zona horaria local: 0 es domingo, 6 sábado.

Ejemplo: 15 de enero de 2024 -> 1, un lunes
Parameters
- inputs: DateDto
  La fecha
Returns number
El día de la semana de 0 a 6
- Defined in bitbybit-docs.d.ts:53247

getYear

getYear(inputs: DateDto): number
Lee el año completo en la zona horaria local.

Ejemplo: 15 de enero de 2024 -> 2024
Parameters
- inputs: DateDto
  La fecha
Returns number
El año
- Defined in bitbybit-docs.d.ts:53258

getMonth

getMonth(inputs: DateDto): number
Lee el mes en la zona horaria local, contando desde 0: 0 es enero, 11 diciembre.

Ejemplo: 15 de enero de 2024 -> 0
Parameters
- inputs: DateDto
  La fecha
Returns number
El mes de 0 a 11
- Defined in bitbybit-docs.d.ts:53269

getHours

getHours(inputs: DateDto): number
Lee la hora, de 0 a 23, en la zona horaria local.

Ejemplo: 14:30 -> 14
Parameters
- inputs: DateDto
  La fecha
Returns number
La hora
- Defined in bitbybit-docs.d.ts:53280

getMinutes

getMinutes(inputs: DateDto): number
Lee los minutos, de 0 a 59, en la zona horaria local.

Ejemplo: 14:30 -> 30
Parameters
- inputs: DateDto
  La fecha
Returns number
Los minutos
- Defined in bitbybit-docs.d.ts:53291

getSeconds

getSeconds(inputs: DateDto): number
Lee los segundos, de 0 a 59, en la zona horaria local.

Ejemplo: 14:30:45 -> 45
Parameters
- inputs: DateDto
  La fecha
Returns number
Los segundos
- Defined in bitbybit-docs.d.ts:53302

getMilliseconds

getMilliseconds(inputs: DateDto): number
Lee los milisegundos, de 0 a 999, en la zona horaria local.

Ejemplo: 14:30:45.123 -> 123
Parameters
- inputs: DateDto
  La fecha
Returns number
Los milisegundos
- Defined in bitbybit-docs.d.ts:53313

getTime

getTime(inputs: DateDto): number
Da la fecha como una marca de tiempo Unix: los milisegundos desde el 1 de enero de 1970 a las 00:00 UTC.

Ejemplo: 15 de enero de 2024 a las 14:30 UTC -> 1705329000000
Parameters
- inputs: DateDto
  La fecha
Returns number
La marca de tiempo en milisegundos
- Defined in bitbybit-docs.d.ts:53324

getUTCYear

getUTCYear(inputs: DateDto): number
Lee el año completo en UTC.

Ejemplo: 15 de enero de 2024 -> 2024
Parameters
- inputs: DateDto
  La fecha
Returns number
El año
- Defined in bitbybit-docs.d.ts:53335

getUTCMonth

getUTCMonth(inputs: DateDto): number
Lee el mes en UTC, contando desde 0: 0 es enero, 11 diciembre.

Ejemplo: 15 de enero de 2024 -> 0
Parameters
- inputs: DateDto
  La fecha
Returns number
El mes de 0 a 11
- Defined in bitbybit-docs.d.ts:53346

getUTCDay

getUTCDay(inputs: DateDto): number
Lee el día del mes, de 1 a 31, en UTC.

Ejemplo: 15 de enero de 2024 -> 15
Parameters
- inputs: DateDto
  La fecha
Returns number
El día del mes
- Defined in bitbybit-docs.d.ts:53357

getUTCHours

getUTCHours(inputs: DateDto): number
Lee la hora, de 0 a 23, en UTC.

Ejemplo: 14:00 UTC -> 14
Parameters
- inputs: DateDto
  La fecha
Returns number
La hora
- Defined in bitbybit-docs.d.ts:53368

getUTCMinutes

getUTCMinutes(inputs: DateDto): number
Lee los minutos, de 0 a 59, en UTC.

Ejemplo: 14:30 UTC -> 30
Parameters
- inputs: DateDto
  La fecha
Returns number
Los minutos
- Defined in bitbybit-docs.d.ts:53379

getUTCSeconds

getUTCSeconds(inputs: DateDto): number
Lee los segundos, de 0 a 59, en UTC.

Ejemplo: 14:30:45 UTC -> 45
Parameters
- inputs: DateDto
  La fecha
Returns number
Los segundos
- Defined in bitbybit-docs.d.ts:53390

getUTCMilliseconds

getUTCMilliseconds(inputs: DateDto): number
Lee los milisegundos, de 0 a 999, en UTC.

Ejemplo: 14:30:45.123 UTC -> 123
Parameters
- inputs: DateDto
  La fecha
Returns number
Los milisegundos
- Defined in bitbybit-docs.d.ts:53401

parse

parseDate

parseDate(inputs: DateStringDto): number
Lee una fecha escrita como texto y da su marca de tiempo Unix, los milisegundos desde el 1 de enero de 1970 a las 00:00 UTC.

El texto ISO 8601 como '2024-01-15' o '2024-01-15T14:30:00Z' se lee de forma fiable; el texto que no puede leerse da NaN. Ejemplo: '2024-01-15' -> 1705276800000
Parameters
- inputs: DateStringDto
  La fecha como texto
Returns number
La marca de tiempo en milisegundos, o NaN cuando el texto no es una fecha
Example
```
const stamp = bitbybit.dates.parseDate({ dateString: "2024-01-15T14:30:00Z" });
```
- Defined in bitbybit-docs.d.ts:53225

set

setYear

setYear(inputs: DateYearDto): Date
Hace una copia de la fecha con otro año, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con año 2025 -> 15 de enero de 2025
Parameters
- inputs: DateYearDto
  La fecha y el año
Returns Date
Una nueva fecha con el año cambiado
Example
```
const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Defined in bitbybit-docs.d.ts:53417

setMonth

setMonth(inputs: DateMonthDto): Date
Hace una copia de la fecha con otro mes, en la zona horaria local; los meses cuentan desde 0. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con mes 5 -> 15 de junio de 2024
Parameters
- inputs: DateMonthDto
  La fecha y el mes de 0 a 11
Returns Date
Una nueva fecha con el mes cambiado
Example
```
const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Defined in bitbybit-docs.d.ts:53433

setDayOfMonth

setDayOfMonth(inputs: DateDayDto): Date
Hace una copia de la fecha con otro día del mes, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con día 20 -> 20 de enero de 2024
Parameters
- inputs: DateDayDto
  La fecha y el día de 1 a 31
Returns Date
Una nueva fecha con el día cambiado
Example
```
const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });
```
- Defined in bitbybit-docs.d.ts:53449

setHours

setHours(inputs: DateHoursDto): Date
Hace una copia de la fecha con otra hora, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 14:30 con horas 9 -> 09:30
Parameters
- inputs: DateHoursDto
  La fecha y la hora de 0 a 23
Returns Date
Una nueva fecha con la hora cambiada
Example
```
const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Defined in bitbybit-docs.d.ts:53465

setMinutes

setMinutes(inputs: DateMinutesDto): Date
Hace una copia de la fecha con otros minutos, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 14:30 con minutos 45 -> 14:45
Parameters
- inputs: DateMinutesDto
  La fecha y los minutos de 0 a 59
Returns Date
Una nueva fecha con los minutos cambiados
Example
```
const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Defined in bitbybit-docs.d.ts:53481

setSeconds

setSeconds(inputs: DateSecondsDto): Date
Hace una copia de la fecha con otros segundos, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 14:30:00 con segundos 30 -> 14:30:30
Parameters
- inputs: DateSecondsDto
  La fecha y los segundos de 0 a 59
Returns Date
Una nueva fecha con los segundos cambiados
Example
```
const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Defined in bitbybit-docs.d.ts:53497

setMilliseconds

setMilliseconds(inputs: DateMillisecondsDto): Date
Hace una copia de la fecha con otros milisegundos, en la zona horaria local. La fecha dada no se modifica.

Ejemplo: 14:30:00.000 con milisegundos 500 -> 14:30:00.500
Parameters
- inputs: DateMillisecondsDto
  La fecha y los milisegundos de 0 a 999
Returns Date
Una nueva fecha con los milisegundos cambiados
Example
```
const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
```
- Defined in bitbybit-docs.d.ts:53513

setTime

setTime(inputs: DateTimeDto): Date
Hace una copia de la fecha movida a una marca de tiempo Unix, los milisegundos desde el 1 de enero de 1970 a las 00:00 UTC. La fecha dada no se modifica.

Ejemplo: cualquier fecha con tiempo 0 -> 1 de enero de 1970 a las 00:00 UTC
Parameters
- inputs: DateTimeDto
  La fecha y la marca de tiempo en milisegundos
Returns Date
Una nueva fecha con la marca de tiempo cambiada
Example
```
const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });
```
- Defined in bitbybit-docs.d.ts:53529

setUTCYear

setUTCYear(inputs: DateYearDto): Date
Hace una copia de la fecha con otro año, en UTC. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con año 2025 -> 15 de enero de 2025
Parameters
- inputs: DateYearDto
  La fecha y el año
Returns Date
Una nueva fecha con el año cambiado
Example
```
const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Defined in bitbybit-docs.d.ts:53544

setUTCMonth

setUTCMonth(inputs: DateMonthDto): Date
Hace una copia de la fecha con otro mes, en UTC; los meses cuentan desde 0. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con mes 5 -> 15 de junio de 2024
Parameters
- inputs: DateMonthDto
  La fecha y el mes de 0 a 11
Returns Date
Una nueva fecha con el mes cambiado
Example
```
const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Defined in bitbybit-docs.d.ts:53560

setUTCDay

setUTCDay(inputs: DateDayDto): Date
Hace una copia de la fecha con otro día del mes, en UTC. La fecha dada no se modifica.

Ejemplo: 15 de enero de 2024 con día 20 -> 20 de enero de 2024
Parameters
- inputs: DateDayDto
  La fecha y el día de 1 a 31
Returns Date
Una nueva fecha con el día cambiado
Example
```
const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });
```
- Defined in bitbybit-docs.d.ts:53576

setUTCHours

setUTCHours(inputs: DateHoursDto): Date
Hace una copia de la fecha con otra hora, en UTC. La fecha dada no se modifica.

Ejemplo: 14:30 UTC con horas 9 -> 09:30 UTC
Parameters
- inputs: DateHoursDto
  La fecha y la hora de 0 a 23
Returns Date
Una nueva fecha con la hora cambiada
Example
```
const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Defined in bitbybit-docs.d.ts:53591

setUTCMinutes

setUTCMinutes(inputs: DateMinutesDto): Date
Hace una copia de la fecha con otros minutos, en UTC. La fecha dada no se modifica.

Ejemplo: 14:30 UTC con minutos 45 -> 14:45 UTC
Parameters
- inputs: DateMinutesDto
  La fecha y los minutos de 0 a 59
Returns Date
Una nueva fecha con los minutos cambiados
Example
```
const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Defined in bitbybit-docs.d.ts:53606

setUTCSeconds

setUTCSeconds(inputs: DateSecondsDto): Date
Hace una copia de la fecha con otros segundos, en UTC. La fecha dada no se modifica.

Ejemplo: 14:30:00 UTC con segundos 30 -> 14:30:30 UTC
Parameters
- inputs: DateSecondsDto
  La fecha y los segundos de 0 a 59
Returns Date
Una nueva fecha con los segundos cambiados
Example
```
const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Defined in bitbybit-docs.d.ts:53621

setUTCMilliseconds

setUTCMilliseconds(inputs: DateMillisecondsDto): Date
Hace una copia de la fecha con otros milisegundos, en UTC. La fecha dada no se modifica.

Ejemplo: 14:30:00.000 UTC con milisegundos 500 -> 14:30:00.500 UTC
Parameters
- inputs: DateMillisecondsDto
  La fecha y los milisegundos de 0 a 999
Returns Date
Una nueva fecha con los milisegundos cambiados
Example
```
const changed = bitbybit.dates.setUTCMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
```
- Defined in bitbybit-docs.d.ts:53636

Class Dates

Index

Constructors

convert

create

get

parse

set

Constructors

constructor

Returns Bit.Dates

convert

toDateString

Parameters

Returns string

toISOString

Parameters

Returns string

toJSON

Parameters

Returns string

toString

Parameters

Returns string

toTimeString

Parameters

Returns string

toUTCString

Parameters

Returns string

create

now

Returns Date

createDate

Parameters

Returns Date

Example

createDateUTC

Parameters

Returns Date

Example

createFromUnixTimeStamp

Parameters

Returns Date

Example

get

getDayOfMonth

Parameters

Returns number

getWeekday

Parameters

Returns number

getYear

Parameters

Returns number

getMonth

Parameters

Returns number

getHours

Parameters

Returns number

getMinutes

Parameters

Returns number

getSeconds

Parameters

Returns number

getMilliseconds

Parameters

Returns number

getTime

Parameters

Returns number

getUTCYear

Parameters

Returns number

getUTCMonth

Parameters

Returns number

getUTCDay