Class Dates

Datas e horas como valores Date de JavaScript: criá-las, ler e definir as suas partes, e formatá-las como texto. Os meses contam a partir de 0 (janeiro é 0, dezembro 11) e os dias da semana a partir de 0 (domingo); os dias do mês contam a partir de 1. Cada setter devolve uma nova data e deixa a data dada inalterada. Existem variantes de hora local e UTC para a maioria das operações.

Constructors

constructor

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

convert

toDateString

toDateString(inputs: DateDto): string
Formata a parte da data como texto, sem a hora, no fuso horário local.

Exemplo: 15 de janeiro de 2024 às 14:30 -> 'Mon Jan 15 2024'
Parameters
- inputs: DateDto
  A data
Returns string
A data como texto, por exemplo 'Mon Jan 15 2024'
- Defined in bitbybit-docs.d.ts:53094

toISOString

toISOString(inputs: DateDto): string
Formata a data e a hora na forma ISO 8601 usada para intercâmbio de dados, sempre em UTC.

Exemplo: 15 de janeiro de 2024 às 14:30 -> '2024-01-15T14:30:45.000Z'
Parameters
- inputs: DateDto
  A data
Returns string
A data como texto, por exemplo '2024-01-15T14:30:45.000Z'
- Defined in bitbybit-docs.d.ts:53105

toJSON

toJSON(inputs: DateDto): string
Formata a data tal como aparece dentro de JSON, que é a forma ISO 8601 em UTC.

Exemplo: 15 de janeiro de 2024 às 14:30 -> '2024-01-15T14:30:00.000Z'
Parameters
- inputs: DateDto
  A data
Returns string
A data como texto, por exemplo '2024-01-15T14:30:00.000Z'
- Defined in bitbybit-docs.d.ts:53116

toString

toString(inputs: DateDto): string
Formata a data e a hora completas como texto no fuso horário local, com o desvio do fuso.

Exemplo: 15 de janeiro de 2024 às 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'
Parameters
- inputs: DateDto
  A data
Returns string
A data e a hora como texto
- Defined in bitbybit-docs.d.ts:53127

toTimeString

toTimeString(inputs: DateDto): string
Formata a parte da hora como texto, sem a data, no fuso horário local com o desvio do fuso.

Exemplo: 15 de janeiro de 2024 às 14:30 -> '14:30:45 GMT+0000'
Parameters
- inputs: DateDto
  A data
Returns string
A hora como texto, por exemplo '14:30:45 GMT+0000'
- Defined in bitbybit-docs.d.ts:53138

toUTCString

toUTCString(inputs: DateDto): string
Formata a data e a hora como texto em UTC.

Exemplo: 15 de janeiro de 2024 às 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'
Parameters
- inputs: DateDto
  A data
Returns string
A data e a hora como texto UTC
- Defined in bitbybit-docs.d.ts:53149

create

now

now(): Date
Dá a data e a hora atuais no momento da chamada.

Returns Date
A data e a hora atuais
- Defined in bitbybit-docs.d.ts:53157

createDate

createDate(inputs: CreateDateDto): Date
Constrói uma data a partir das suas partes, lidas no fuso horário local.

O mês conta a partir de 0: 0 é janeiro, 11 dezembro. Uma parte fora do seu intervalo transborda, por isso o dia 32 de janeiro passa a ser o primeiro de fevereiro. Exemplo: ano 2024, mês 0, dia 15, horas 14, minutos 30 -> 15 de janeiro de 2024 às 14:30 hora local
Parameters
- inputs: CreateDateDto
  O ano, o mês, o dia, as horas, os minutos, os segundos e os milissegundos
Returns Date
A data
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
Constrói uma data a partir das suas partes, lidas como UTC de modo que o fuso horário local não intervém.

O mês conta a partir de 0: 0 é janeiro, 11 dezembro. Uma parte fora do seu intervalo transborda. Exemplo: ano 2024, mês 0, dia 15 -> 15 de janeiro de 2024 às 00:00 UTC
Parameters
- inputs: CreateDateDto
  O ano, o mês, o dia, as horas, os minutos, os segundos e os milissegundos
Returns Date
A data
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
Constrói uma data a partir de um carimbo temporal Unix: o número de milissegundos desde 1 de janeiro de 1970 às 00:00 UTC.

Exemplo: 1705329000000 -> 15 de janeiro de 2024 às 14:30 UTC
Parameters
- inputs: CreateFromUnixTimeStampDto
  O timestamp em milissegundos
Returns Date
A data
Example
```
const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });
```
- Defined in bitbybit-docs.d.ts:53207

get

getDayOfMonth

getDayOfMonth(inputs: DateDto): number
Lê o dia do mês, de 1 a 31, no fuso horário local.

Exemplo: 15 de janeiro de 2024 -> 15
Parameters
- inputs: DateDto
  A data
Returns number
O dia do mês
- Defined in bitbybit-docs.d.ts:53236

getWeekday

getWeekday(inputs: DateDto): number
Lê o dia da semana no fuso horário local: 0 é domingo, 6 sábado.

Exemplo: 15 de janeiro de 2024 -> 1, uma segunda-feira
Parameters
- inputs: DateDto
  A data
Returns number
O dia da semana de 0 a 6
- Defined in bitbybit-docs.d.ts:53247

getYear

getYear(inputs: DateDto): number
Lê o ano completo no fuso horário local.

Exemplo: 15 de janeiro de 2024 -> 2024
Parameters
- inputs: DateDto
  A data
Returns number
O ano
- Defined in bitbybit-docs.d.ts:53258

getMonth

getMonth(inputs: DateDto): number
Lê o mês no fuso horário local, a contar de 0: 0 é janeiro, 11 dezembro.

Exemplo: 15 de janeiro de 2024 -> 0
Parameters
- inputs: DateDto
  A data
Returns number
O mês de 0 a 11
- Defined in bitbybit-docs.d.ts:53269

getHours

getHours(inputs: DateDto): number
Lê a hora, de 0 a 23, no fuso horário local.

Exemplo: 14:30 -> 14
Parameters
- inputs: DateDto
  A data
Returns number
A hora
- Defined in bitbybit-docs.d.ts:53280

getMinutes

getMinutes(inputs: DateDto): number
Lê os minutos, de 0 a 59, no fuso horário local.

Exemplo: 14:30 -> 30
Parameters
- inputs: DateDto
  A data
Returns number
Os minutos
- Defined in bitbybit-docs.d.ts:53291

getSeconds

getSeconds(inputs: DateDto): number
Lê os segundos, de 0 a 59, no fuso horário local.

Exemplo: 14:30:45 -> 45
Parameters
- inputs: DateDto
  A data
Returns number
Os segundos
- Defined in bitbybit-docs.d.ts:53302

getMilliseconds

getMilliseconds(inputs: DateDto): number
Lê os milissegundos, de 0 a 999, no fuso horário local.

Exemplo: 14:30:45.123 -> 123
Parameters
- inputs: DateDto
  A data
Returns number
Os milissegundos
- Defined in bitbybit-docs.d.ts:53313

getTime

getTime(inputs: DateDto): number
Dá a data como um carimbo temporal Unix: os milissegundos desde 1 de janeiro de 1970 às 00:00 UTC.

Exemplo: 15 de janeiro de 2024 às 14:30 UTC -> 1705329000000
Parameters
- inputs: DateDto
  A data
Returns number
O timestamp em milissegundos
- Defined in bitbybit-docs.d.ts:53324

getUTCYear

getUTCYear(inputs: DateDto): number
Lê o ano completo em UTC.

Exemplo: 15 de janeiro de 2024 -> 2024
Parameters
- inputs: DateDto
  A data
Returns number
O ano
- Defined in bitbybit-docs.d.ts:53335

getUTCMonth

getUTCMonth(inputs: DateDto): number
Lê o mês em UTC, a contar de 0: 0 é janeiro, 11 dezembro.

Exemplo: 15 de janeiro de 2024 -> 0
Parameters
- inputs: DateDto
  A data
Returns number
O mês de 0 a 11
- Defined in bitbybit-docs.d.ts:53346

getUTCDay

getUTCDay(inputs: DateDto): number
Lê o dia do mês, de 1 a 31, em UTC.

Exemplo: 15 de janeiro de 2024 -> 15
Parameters
- inputs: DateDto
  A data
Returns number
O dia do mês
- Defined in bitbybit-docs.d.ts:53357

getUTCHours

getUTCHours(inputs: DateDto): number
Lê a hora, de 0 a 23, em UTC.

Exemplo: 14:00 UTC -> 14
Parameters
- inputs: DateDto
  A data
Returns number
A hora
- Defined in bitbybit-docs.d.ts:53368

getUTCMinutes

getUTCMinutes(inputs: DateDto): number
Lê os minutos, de 0 a 59, em UTC.

Exemplo: 14:30 UTC -> 30
Parameters
- inputs: DateDto
  A data
Returns number
Os minutos
- Defined in bitbybit-docs.d.ts:53379

getUTCSeconds

getUTCSeconds(inputs: DateDto): number
Lê os segundos, de 0 a 59, em UTC.

Exemplo: 14:30:45 UTC -> 45
Parameters
- inputs: DateDto
  A data
Returns number
Os segundos
- Defined in bitbybit-docs.d.ts:53390

getUTCMilliseconds

getUTCMilliseconds(inputs: DateDto): number
Lê os milissegundos, de 0 a 999, em UTC.

Exemplo: 14:30:45.123 UTC -> 123
Parameters
- inputs: DateDto
  A data
Returns number
Os milissegundos
- Defined in bitbybit-docs.d.ts:53401

parse

parseDate

parseDate(inputs: DateStringDto): number
Lê uma data escrita como texto e dá o seu carimbo temporal Unix, os milissegundos desde 1 de janeiro de 1970 às 00:00 UTC.

Texto ISO 8601 como '2024-01-15' ou '2024-01-15T14:30:00Z' é lido de forma fiável; texto que não possa ser lido dá NaN. Exemplo: '2024-01-15' -> 1705276800000
Parameters
- inputs: DateStringDto
  A data como texto
Returns number
O timestamp em milissegundos, ou NaN quando o texto não é uma data
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
Cria uma cópia da data com outro ano, no fuso horário local. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com ano 2025 -> 15 de janeiro de 2025
Parameters
- inputs: DateYearDto
  A data e o ano
Returns Date
Uma nova data com o ano alterado
Example
```
const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Defined in bitbybit-docs.d.ts:53417

setMonth

setMonth(inputs: DateMonthDto): Date
Cria uma cópia da data com outro mês, no fuso horário local; os meses contam a partir de 0. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com mês 5 -> 15 de junho de 2024
Parameters
- inputs: DateMonthDto
  A data e o mês de 0 a 11
Returns Date
Uma nova data com o mês alterado
Example
```
const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Defined in bitbybit-docs.d.ts:53433

setDayOfMonth

setDayOfMonth(inputs: DateDayDto): Date
Cria uma cópia da data com outro dia do mês, no fuso horário local. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com dia 20 -> 20 de janeiro de 2024
Parameters
- inputs: DateDayDto
  A data e o dia de 1 a 31
Returns Date
Uma nova data com o dia alterado
Example
```
const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });
```
- Defined in bitbybit-docs.d.ts:53449

setHours

setHours(inputs: DateHoursDto): Date
Cria uma cópia da data com outra hora, no fuso horário local. A data dada não é alterada.

Exemplo: 14:30 com horas 9 -> 09:30
Parameters
- inputs: DateHoursDto
  A data e a hora de 0 a 23
Returns Date
Uma nova data com a hora alterada
Example
```
const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Defined in bitbybit-docs.d.ts:53465

setMinutes

setMinutes(inputs: DateMinutesDto): Date
Cria uma cópia da data com outros minutos, no fuso horário local. A data dada não é alterada.

Exemplo: 14:30 com minutos 45 -> 14:45
Parameters
- inputs: DateMinutesDto
  A data e os minutos de 0 a 59
Returns Date
Uma nova data com os minutos alterados
Example
```
const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Defined in bitbybit-docs.d.ts:53481

setSeconds

setSeconds(inputs: DateSecondsDto): Date
Cria uma cópia da data com outros segundos, no fuso horário local. A data dada não é alterada.

Exemplo: 14:30:00 com segundos 30 -> 14:30:30
Parameters
- inputs: DateSecondsDto
  A data e os segundos de 0 a 59
Returns Date
Uma nova data com os segundos alterados
Example
```
const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Defined in bitbybit-docs.d.ts:53497

setMilliseconds

setMilliseconds(inputs: DateMillisecondsDto): Date
Cria uma cópia da data com outros milissegundos, no fuso horário local. A data dada não é alterada.

Exemplo: 14:30:00.000 com milissegundos 500 -> 14:30:00.500
Parameters
- inputs: DateMillisecondsDto
  A data e os milissegundos de 0 a 999
Returns Date
Uma nova data com os milissegundos alterados
Example
```
const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
```
- Defined in bitbybit-docs.d.ts:53513

setTime

setTime(inputs: DateTimeDto): Date
Cria uma cópia da data movida para um carimbo temporal Unix, os milissegundos desde 1 de janeiro de 1970 às 00:00 UTC. A data dada não é alterada.

Exemplo: qualquer data com tempo 0 -> 1 de janeiro de 1970 às 00:00 UTC
Parameters
- inputs: DateTimeDto
  A data e o timestamp em milissegundos
Returns Date
Uma nova data com o timestamp alterado
Example
```
const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });
```
- Defined in bitbybit-docs.d.ts:53529

setUTCYear

setUTCYear(inputs: DateYearDto): Date
Cria uma cópia da data com outro ano, em UTC. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com ano 2025 -> 15 de janeiro de 2025
Parameters
- inputs: DateYearDto
  A data e o ano
Returns Date
Uma nova data com o ano alterado
Example
```
const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });
```
- Defined in bitbybit-docs.d.ts:53544

setUTCMonth

setUTCMonth(inputs: DateMonthDto): Date
Cria uma cópia da data com outro mês, em UTC; os meses contam a partir de 0. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com mês 5 -> 15 de junho de 2024
Parameters
- inputs: DateMonthDto
  A data e o mês de 0 a 11
Returns Date
Uma nova data com o mês alterado
Example
```
const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });
```
- Defined in bitbybit-docs.d.ts:53560

setUTCDay

setUTCDay(inputs: DateDayDto): Date
Cria uma cópia da data com outro dia do mês, em UTC. A data dada não é alterada.

Exemplo: 15 de janeiro de 2024 com dia 20 -> 20 de janeiro de 2024
Parameters
- inputs: DateDayDto
  A data e o dia de 1 a 31
Returns Date
Uma nova data com o dia alterado
Example
```
const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });
```
- Defined in bitbybit-docs.d.ts:53576

setUTCHours

setUTCHours(inputs: DateHoursDto): Date
Cria uma cópia da data com outra hora, em UTC. A data dada não é alterada.

Exemplo: 14:30 UTC com horas 9 -> 09:30 UTC
Parameters
- inputs: DateHoursDto
  A data e a hora de 0 a 23
Returns Date
Uma nova data com a hora alterada
Example
```
const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });
```
- Defined in bitbybit-docs.d.ts:53591

setUTCMinutes

setUTCMinutes(inputs: DateMinutesDto): Date
Cria uma cópia da data com outros minutos, em UTC. A data dada não é alterada.

Exemplo: 14:30 UTC com minutos 45 -> 14:45 UTC
Parameters
- inputs: DateMinutesDto
  A data e os minutos de 0 a 59
Returns Date
Uma nova data com os minutos alterados
Example
```
const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });
```
- Defined in bitbybit-docs.d.ts:53606

setUTCSeconds

setUTCSeconds(inputs: DateSecondsDto): Date
Cria uma cópia da data com outros segundos, em UTC. A data dada não é alterada.

Exemplo: 14:30:00 UTC com segundos 30 -> 14:30:30 UTC
Parameters
- inputs: DateSecondsDto
  A data e os segundos de 0 a 59
Returns Date
Uma nova data com os segundos alterados
Example
```
const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });
```
- Defined in bitbybit-docs.d.ts:53621

setUTCMilliseconds

setUTCMilliseconds(inputs: DateMillisecondsDto): Date
Cria uma cópia da data com outros milissegundos, em UTC. A data dada não é alterada.

Exemplo: 14:30:00.000 UTC com milissegundos 500 -> 14:30:00.500 UTC
Parameters
- inputs: DateMillisecondsDto
  A data e os milissegundos de 0 a 999
Returns Date
Uma nova data com os milissegundos alterados
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