From d888b047cf3af63b632ec499bb188923d88fb55e Mon Sep 17 00:00:00 2001 From: Bang Sunghwan Date: Mon, 20 Aug 2018 21:39:26 +0900 Subject: [PATCH 01/23] Fix Korean grammar --- src/locale/ko.js | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/src/locale/ko.js b/src/locale/ko.js index 093ccb691..462c4e637 100644 --- a/src/locale/ko.js +++ b/src/locale/ko.js @@ -9,16 +9,16 @@ const locale = { future: '%s 이내', past: '%s 전', s: '몇 초', - m: '1 분', - mm: '%d 분', - h: '1 시간', - hh: '%d 시간', - d: '1 일', - dd: '%d 일', - M: '1 개월', - MM: '%d 개월', - y: '1 년', - yy: '%d 년' + m: '1분', + mm: '%d분', + h: '1시간', + hh: '%d시간', + d: '1일', + dd: '%d일', + M: '1개월', + MM: '%d개월', + y: '1년', + yy: '%d년' } } From 4efd3b2d63eb4e6d71e4e960f43a9a53b3d0d672 Mon Sep 17 00:00:00 2001 From: Bang Sunghwan Date: Mon, 20 Aug 2018 21:52:29 +0900 Subject: [PATCH 02/23] Follow moment's translation --- src/locale/ko.js | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/locale/ko.js b/src/locale/ko.js index 462c4e637..02b75d4a7 100644 --- a/src/locale/ko.js +++ b/src/locale/ko.js @@ -6,18 +6,18 @@ const locale = { months: '1월_2월_3월_4월_5월_6월_7월_8월_9월_10월_11월_12월'.split('_'), ordinal: n => n, relativeTime: { - future: '%s 이내', + future: '%s 후', past: '%s 전', s: '몇 초', m: '1분', mm: '%d분', - h: '1시간', + h: '한 시간', hh: '%d시간', - d: '1일', + d: '하루', dd: '%d일', - M: '1개월', - MM: '%d개월', - y: '1년', + M: '한 달', + MM: '%d달', + y: '일 년', yy: '%d년' } } From c0ebad41888eae1cd8fa5e667d8b3ace9d3f62af Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?b=C3=A9la?= Date: Wed, 12 Sep 2018 13:15:04 +0200 Subject: [PATCH 03/23] add hungarian locale --- src/locale/hu.js | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 src/locale/hu.js diff --git a/src/locale/hu.js b/src/locale/hu.js new file mode 100644 index 000000000..345944fc1 --- /dev/null +++ b/src/locale/hu.js @@ -0,0 +1,30 @@ +import dayjs from 'dayjs' + +const locale = { + name: 'hu', + weekdays: 'vasárnap_hétfő_kedd_szerda_csütörtök_péntek_szombat'.split('_'), + weekdaysShort: 'vas_hét_kedd_sze_csüt_pén_szo'.split('_'), + weekdaysMin: 'v_h_k_sze_cs_p_szo'.split('_'), + months: 'január_február_március_április_május_június_július_augusztus_szeptember_október_november_december'.split('_'), + monthsShort: 'jan_feb_márc_ápr_máj_jún_júl_aug_szept_okt_nov_dec'.split('_'), + ordinal: n => `${n}.`, + relativeTime: { + future: '%s múlva', + past: '%s', + s: 'néhány másodperc', + m: 'egy perce', + mm: '%d perc', + h: 'egy órája', + hh: '%d óra', + d: 'egy napja', + dd: '%d nap', + M: 'egy hónapja', + MM: '%d hónap', + y: 'egy éve', + yy: '%d év' + } +} + +dayjs.locale(locale, null, true) + +export default locale From 0c51b89720985baaf0bb8cb1bc658f03fe54845f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?b=C3=A9la?= Date: Wed, 12 Sep 2018 13:19:20 +0200 Subject: [PATCH 04/23] fixing hungarian locale --- src/locale/hu.js | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/locale/hu.js b/src/locale/hu.js index 345944fc1..021a401c9 100644 --- a/src/locale/hu.js +++ b/src/locale/hu.js @@ -12,13 +12,13 @@ const locale = { future: '%s múlva', past: '%s', s: 'néhány másodperc', - m: 'egy perce', + m: 'egy perc', mm: '%d perc', - h: 'egy órája', + h: 'egy óra', hh: '%d óra', - d: 'egy napja', + d: 'egy nap', dd: '%d nap', - M: 'egy hónapja', + M: 'egy hónap', MM: '%d hónap', y: 'egy éve', yy: '%d év' From bc7c120972ea46239b216e6c7857fbdc2d022d2e Mon Sep 17 00:00:00 2001 From: Renan Gomes Date: Thu, 20 Sep 2018 18:44:53 -0300 Subject: [PATCH 05/23] Synchronizing the pt-br API documentation with the original one. --- docs/pt-br/API-reference.md | 399 ++++++++++++++++-------------------- docs/pt-br/I18n.md | 49 +++-- docs/pt-br/Installation.md | 4 +- docs/pt-br/Plugin.md | 88 ++++---- docs/pt-br/README-pt-br.md | 38 +++- 5 files changed, 277 insertions(+), 301 deletions(-) diff --git a/docs/pt-br/API-reference.md b/docs/pt-br/API-reference.md index d926058ed..7f4a686e3 100644 --- a/docs/pt-br/API-reference.md +++ b/docs/pt-br/API-reference.md @@ -1,281 +1,250 @@ ## Referência da API -Ao invés de modificar o 'Date.prototype' nativo, o Day.js empacota o objeto nativo Date em um objeto `Dayjs`. - -Este objeto `Dayjs` é imutável, ou seja, todas as operações desta API irão retornar um novo objeto `Dayjs`. - -* [Criação](#criação) - * [Data e Hora Atual](#data-e-hora-atual) - * [String](#string) - * [Unix Timestamp (millisegundos)](#unix-timestamp-millisegundos) - * [Date](#date) - * [Clonar](#clonar) - * [Validação](#validação) -* [Get e Set](#get-e-set) - * [Ano](#ano) - * [Mês](#mês) - * [Dia do Mês](#dia-do-mês) - * [Dia da Semana](#dia-da-semana) - * [Hora](#hora) - * [Minuto](#minuto) - * [Segundo](#segundo) - * [Milisegundo](#milisegundo) - * [Set](#set) -* [Manipulação](#manipulação) - * [Adicionar Tempo](#adicionar-tempo) - * [Subtrair Tempo](#subtrair-tempo) - * [Começo do Tempo](#começo-do-tempo) - * [Fim do Tempo](#fim-do-tempo) -* [Visualização](#visualização) - * [Formatar](#formatar) - * [Diferença](#diferença) - * [Unix Timestamp (milliseconds)](#unix-timestamp-milissegundos-1) - * [Unix Timestamp (seconds)](#unix-timestamp-segundos) - * [Dias no Mês](#days-in-month) - * [Como Date do Javascript](#como-date-do-javascript) - * [Como Array](#como-array) - * [Como JSON](#como-json) - * [Como String ISO 8601](#como-string-iso-8601) - * [Como Object](#como-object) - * [Como String](#como-string) -* [Verificação](#verificação) - * [Antes](#antes) - * [Igual](#igual) - * [Depois](#depois) - * [Is a Dayjs `.isDayjs()`](#is-a-dayjs-isdayjscompared-any) -* [Plugin APIs](#plugin-apis) - * [RelativeTime](#relativetime) - * [IsLeapYear](#isleapyear) - * [WeekOfYear](#weekofyear) - * [IsBetween](#isbetween) - ---- -O Day.js sempre irá retornar um novo objeto `Dayjs` se nada for especificado. - -### Criação - -Pode-se criar objetos Dayjs chamando `dayjs()`, passando um dos vários tipos de parâmetro disponíveis. - -#### Data e hora atual - -Se não passar nenhum parâmetro, o objeto `Dayjs` usará a data e hora atual. +Ao invés de modificar o `Date.prototype` nativo, o Day.js empacota o objeto nativo `Date` em um objeto `Dayjs`. + +O objeto `Dayjs` é imutável, ou seja, todas as operações da API que alteram o objeto `Dayjs` irão retornar uma nova instancia deste objeto. + +- [Referência da API](#api-reference) + - [Conversões](#parsing) + - [Construtor `dayjs(existing?: string | number | Date | Dayjs)`](#constructor-dayjsexisting-string--number--date--dayjs) + - [string ISO 8601](#iso-8601-string) + - [Unix Timestamp (milissegundos desde a Unix Epoch - Jan 1 1970, 12AM UTC)](#unix-timestamp-milliseconds-since-the-unix-epoch---jan-1-1970-12am-utc) + - [Objeto `Date` nativo](#native-javascript-date-object) + - [Clonar `.clone() | dayjs(original: Dayjs)`](#clone-clone-dayjsoriginal-dayjs) + - [Validação `.isValid()`](#validation-isvalid) + - [Get and Set](#get-and-set) + - [Ano `.year()`](#year-year) + - [Mês `.month()`](#month-month) + - [Dia do Mês `.date()`](#day-of-the-month-date) + - [Dia da Semana `.day()`](#day-of-the-week-day) + - [Hora `.hour()`](#hour-hour) + - [Minuto `.minute()`](#minute-minute) + - [Segundo `.second()`](#second-second) + - [Milissegundo `.millisecond()`](#millisecond-millisecond) + - [Set `.set(unit: string, value: number)`](#set-setunit-string-value-number) + - [Manipulando](#manipulating) + - [Adicionar `.add(value: number, unit: string)`](#add-addvalue-number-unit-string) + - [Subtrair `.subtract(value: number, unit: string)`](#subtract-subtractvalue-number-unit-string) + - [Início do Tempo `.startOf(unit: string)`](#start-of-time-startofunit-string) + - [Fim do Tempo `.endOf(unit: string)`](#end-of-time-endofunit-string) + - [Exibindo](#displaying) + - [Formatação `.format(stringWithTokens: string)`](#format-formatstringwithtokens-string) + - [Lista com todos os formatos disponíveis](#list-of-all-available-formats) + - [Diferença `.diff(compared: Dayjs, unit: string (padrão: 'milliseconds'), float?: boolean)`](#difference-diffcompared-dayjs-unit-string-default-milliseconds-float-boolean) + - [Unix Timestamp (milissegundos) `.valueOf()`](#unix-timestamp-milliseconds-valueof) + - [Unix Timestamp (segundos) `.unix()`](#unix-timestamp-seconds-unix) + - [Dias no Mês `.daysInMonth()`](#days-in-the-month-daysinmonth) + - [Como objeto `Date` do Javascript `.toDate()`](#as-javascript-date-todate) + - [Como Array `.toArray()`](#as-array-toarray) + - [Como JSON `.toJSON()`](#as-json-tojson) + - [Como uma string ISO 8601 `.toISOString()`](#as-iso-8601-string-toisostring) + - [Como Objeto `.toObject()`](#as-object-toobject) + - [Como String `.toString()`](#as-string-tostring) + - [Consulta](#query) + - [Antes `.isBefore(compared: Dayjs)`](#is-before-isbeforecompared-dayjs) + - [Igual `.isSame(compared: Dayjs)`](#is-same-issamecompared-dayjs) + - [Depois `.isAfter(compared: Dayjs)`](#is-after-isaftercompared-dayjs) + - [É um objeto `Dayjs` `.isDayjs()`](#is-a-dayjs-isdayjscompared-any) + - [Plugin](#plugin-apis) + - [RelativeTime](#relativetime) + - [IsLeapYear](#isleapyear) + - [WeekOfYear](#weekofyear) + - [IsBetween](#isbetween) + +## Conversões + +### Construtor `dayjs(existing?: string | number | Date | Dayjs)` + +Chamando este construtor sem parâmetros, será retornado um objeto `Dayjs` contendo a data e hora atual. ```js dayjs(); ``` -### String +Day.js também converte outros formatos de data. -String que atende ao formato [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). +#### string [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) ```js -dayjs(String); -dayjs('1995-12-25'); +dayjs('2018-04-04T16:00:00.000Z'); ``` -### Unix Timestamp (millisegundos) - -Valor inteiro representando o número de milissegundos desde o Unix Epoch (meio-dia de 1º de janeiro de 1970, no fuso horário UTC). +#### Unix Timestamp (milissegundos desde a Unix Epoch - Jan 1 1970, 12AM UTC) ```js -dayjs(Number); dayjs(1318781876406); ``` -### Date - -Objeto Date nativo do Javascript. +#### Objeto `Date` nativo ```js -dayjs(Date); dayjs(new Date(2018, 8, 18)); ``` -### Clonar +### Clonar `.clone() | dayjs(original: Dayjs)` -Todos os objetos `Dayjs` são imutáveis. Se quiser uma cópia, simplesmente chame `.clone()`. -Chamar `dayjs()` passando um objeto `Dayjs` também irá cloná-lo. +Retorna um objeto `Dayjs` clonado. ```js -dayjs(Dayjs); dayjs().clone(); +dayjs(dayjs('2019-01-25')); // passando um objeto Dayjs para o construtor também irá cloná-lo ``` -### Validação - -* retorna um Boolean +### Validação `.isValid()` -Se a data do objeto `Dayjs` é considerada válida. +Retorna um `boolean` indicando se a data do objeto `Dayjs` é válida. ```js dayjs().isValid(); ``` ---- +## Get and Set -### Get e Set +### Ano `.year()` -Obter (get) e modificar (set) datas. - -#### Ano - -* retorna um Number. +Retorna um `number` representando o ano do objeto `Dayjs`. ```js dayjs().year(); ``` -#### Mês +### Mês `.month()` -* retorna um Number +Retorna um `number` representando o mês do objeto `Dayjs`. ```js dayjs().month(); ``` -#### Dia do Mês +### Dia do Mês `.date()` -* retorna um Number +Retorna um `number` representando o dia do mês do objeto `Dayjs`. ```js dayjs().date(); ``` -#### Dia da Semana +### Dia da Semana `.day()` -* retorna um Number +Retorna um `number` representando o dia da semana do objeto `Dayjs`. ```js dayjs().day(); ``` -#### Hora +### Hora `.hour()` -* retorna um Number +Retorna um `number` representando a hora do objeto `Dayjs`. ```js dayjs().hour(); ``` -#### Minuto +### Minuto `.minute()` -* retorna um Number +Retorna um `number` representando os minutos do objeto `Dayjs`. ```js dayjs().minute(); ``` -#### Segundo +### Segundo `.second()` -* retorna um Number +Retorna um `number` representando os segundos do objeto `Dayjs`. ```js dayjs().second(); ``` -#### Milisegundo +### Milissegundo `.millisecond()` -* retorna um Number +Retorna um `number` representando os milissegundos do objeto `Dayjs`. ```js dayjs().millisecond(); ``` -#### Set +### Set `.set(unit: string, value: number)` -Modificar a data. -As unidades não fazem distinção entre maiúsculas e minúsculas. +Retorna um `Dayjs` com as mudanças aplicadas. ```js -dayjs().set((unit: String), (value: Int)); dayjs().set('date', 1); dayjs().set('month', 3); // April dayjs().set('second', 30); ``` -#### List of all available units - -| Unit | Shorthand | Description | -| ------------- | --------- | ---------------------------------------- | -| `date` | | Date of Month | -| `day` | `d` | Day of Week (Sunday as 0, Saturday as 6) | -| `month` | `M` | Month | -| `year` | `y` | Year | -| `hour` | `h` | Hour | -| `minute` | `m` | Minute | -| `second` | `s` | Second | -| `millisecond` | `ms` | Millisecond | +#### Lista de todas as unidades disponíveis ---- +| Unidade | Shorthand | Descrição | +| ------------- | --------- | --------------------------------------------- | +| `date` | | Data do Mês | +| `day` | `d` | Dia da Semana (Domingo como 0, Sábado como 6) | +| `month` | `M` | Mês | +| `year` | `y` | Ano | +| `hour` | `h` | Hora | +| `minute` | `m` | Minuto | +| `second` | `s` | Segundo | +| `millisecond` | `ms` | Milissegundo | -### Manipulação +## Manipulando -É possível manipular um objeto `Dayjs` de várias formas. Por exemplo: +Um objeto `Dayjs` pode ser manipulado de várias maneiras. ```js -dayjs() - .startOf('month') +dayjs('2019-01-25') .add(1, 'day') - .subtract(1, 'year'); + .subtract(1, 'year').toString(); // Fri, 26 Jan 2018 00:00:00 GMT ``` -#### Adicionar Tempo +### Adicionar `.add(value: number, unit: string)` -Novo objeto `Dayjs` com tempo adicionado. +Retorna um objeto `Dayjs` clonado com a quantidade especificada de dias adicionados. ```js -dayjs().add((value: Number), (unit: String)); dayjs().add(7, 'day'); ``` -#### Subtrair Tempo +### Subtrair `.subtract(value: number, unit: string)` -Novo objeto `Dayjs`com tempo subtraído. +Retorna um objeto `Dayjs` clonado com a quantidade especificada de dias subtraídos. ```js -dayjs().subtract((value: Number), (unit: String)); dayjs().subtract(7, 'year'); ``` -#### Começo do Tempo +### Início do Tempo `.startOf(unit: string)` -Novo objeto `Dayjs`com tempo voltado para o começo da unidade de tempo passada. +Retorna um objeto `Dayjs` clonado definido com o começo da unidade de tempo especificada. ```js -dayjs().startOf((unit: String)); -dayjs().startOf('year'); +dayjs().startOf('week'); ``` -#### Fim do Tempo +### Fim do Tempo `.endOf(unit: string)` -Novo objeto `Dayjs`com tempo adiantado para o fim da unidade de tempo passada. +Retorna um objeto `Dayjs` clonado definido com o fim da unidade de tempo especificada. ```js -dayjs().endOf((unit: String)); dayjs().endOf('month'); ``` ---- +## Exibindo -### Visualização +### Formatação `.format(stringWithTokens: string)` -Existem várias maneiras de mostrar o objeto `Dayjs` para o usuário. +Retorna uma `string` com um objeto `Dayjs` contendo a data formatada. +Para escapar caracteres, envolva-os entre colchetes ou chaves (por exemplo: `[G] {um}`). -#### Formatar - -* retorna uma string +```js +dayjs().format(); // current date in ISO6801, without fraction seconds e.g. '2020-04-02T08:02:17-05:00' -Recebe uma string com símbolos que serão substituídos por seus valores correspondentes. +dayjs('2019-01-25').format('{YYYY} MM-DDTHH:mm:ssZ[Z]'); // '{2019} 01-25T00:00:00-02:00Z' -```js -dayjs().format(String); -dayjs().format(); // "2014-09-08T08:02:17-05:00" (ISO 8601, sem fração de segundo) -dayjs().format('{YYYY} MM-DDTHH:mm:ssZ[Z]'); // "{2014} 09-08T08:02:17-05:00Z" +dayjs('2019-01-25').format('DD/MM/YYYY'); // '25/01/2019' ``` -* Para não processar caracteres na string passada como parâmetro, coloque-os entre chaves (ex: [Z]). - -Lista de todos os formatos disponíveis: +#### Lista com todos os formatos disponíveis | Formato | Saída | Descrição | | ------ | ---------------- | --------------------------------------------- | @@ -305,147 +274,129 @@ Lista de todos os formatos disponíveis: | `A` | AM PM | | | `a` | am pm | | -* More available formats `Q Do k kk X x ...` in plugin [`AdvancedFormat`](./Plugin.md#advancedformat) - -#### Diferença +* Mais formatos disponíveis `Q Do k kk X x ...` no plugin [`AdvancedFormat`](./Plugin.md#advancedformat) -* retorna um Number +### Diferença `.diff(compared: Dayjs, unit: string (padrão: 'milliseconds'), float?: boolean)` -Diferença de dois objetos `Dayjs` em milissegundos ou outra unidade de tempo especificada. +Retorna um `number` indicando a diferença entre dois objetos `Dayjs` na unidade especificada. ```js -dayjs().diff(Dayjs, unit); -dayjs().diff(dayjs(), 'years'); // 0 +const date1 = dayjs('2019-01-25'); +const date2 = dayjs('2018-06-05'); +date1.diff(date2); // 20214000000 +date1.diff(date2, 'months'); // 7 +date1.diff(date2, 'months', true); // 7.645161290322581 +date1.diff(date2, 'days'); // 233 ``` -#### Unix Timestamp (milissegundos) - -* retorna um Number +### Unix Timestamp (milissegundos) `.valueOf()` -Número de milissegundos desde o Unix Epoch. +Retorna um `number` em milissegundos desde a Unix Epoch para o objeto `Dayjs`. ```js -dayjs().valueOf(); +dayjs('2019-01-25').valueOf(); // 1548381600000 ``` -#### Unix Timestamp (segundos) +### Unix Timestamp (segundos) `.unix()` -* retorna um Number - -Número de segundos desde o Unix Epoch. +Retorna um `number` em segundos desde a Unix Epoch para o objeto `Dayjs`. ```js -dayjs().unix(); +dayjs('2019-01-25').unix(); // 1548381600 ``` -#### Dias no Mês - -* retorna um Number +### Dias no Mês `.daysInMonth()` -Número de dias no mês atual. +Retorna um `number` em contendo o número de dias no mês do objeto `Dayjs`. ```js -dayjs().daysInMonth(); +dayjs('2019-01-25').daysInMonth(); // 31 ``` -#### Como Date do Javascript - -* retorna um objeto `Date` do Javascript +### Como objeto `Date` do Javascript `.toDate()` -Obter cópia de um objeto `Date` nativo a partir do objeto `Dayjs`. +Retorna uma cópia do objeto nativo `Date` convertido de um objeto `Dayjs`. ```js -dayjs().toDate(); +dayjs('2019-01-25').toDate(); ``` -#### Como Array +### Como Array `.toArray()` -* retorna um Array - -Retorna um array no formato dos parâmetros de `new Date()`. +Retorna um `array` que espelha os parâmetros de um new Date(). ```js -dayjs().toArray(); //[2018, 8, 18, 00, 00, 00, 000]; +dayjs('2019-01-25').toArray(); // [ 2019, 0, 25, 0, 0, 0, 0 ] ``` -#### Como JSON - -* retorna uma string +### Como JSON `.toJSON()` -Ao serializar um objeto `Dayjs` para JSON, retornará uma string no padrão ISO 8601. +Retorna o objeto `Dayjs` formatado em uma `string` ISO8601. ```js -dayjs().toJSON(); //"2018-08-08T00:00:00.000Z" +dayjs('2019-01-25').toJSON(); // '2019-01-25T02:00:00.000Z' ``` -#### Como String ISO 8601 - -* retorna uma string +### Como uma string ISO 8601 `.toISOString()` -Retorna uma string no padrão ISO 8601. +Retorna o objeto `Dayjs` formatado em uma `string` ISO8601. ```js -dayjs().toISOString(); +dayjs('2019-01-25').toISOString(); // '2019-01-25T02:00:00.000Z' ``` -#### Como Object +### Como Objeto `.toObject()` -* retorna um Object - -Retorna um Object contendo de ano a milisegundo. +Retorna um `object` com as propriedades da data. ```js -dayjs().toObject(); // { years:2018, months:8, date:18, hours:0, minutes:0, seconds:0, milliseconds:0} +dayjs('2019-01-25').toObject(); +/* { years: 2019, + months: 0, + date: 25, + hours: 0, + minutes: 0, + seconds: 0, + milliseconds: 0 } */ ``` -#### Como String +### Como String `.toString()` -* retorna uma string +Retorna uma representação em `string` da data. ```js -dayjs().toString(); +dayjs('2019-01-25').toString(); // 'Fri, 25 Jan 2019 02:00:00 GMT' ``` ---- - -### Verificação - -#### Antes +## Consulta -* retorna um Boolean +### Antes `.isBefore(compared: Dayjs)` -Se a data de um objeto `Dayjs` é anterior à de outro objeto `Dayjs`. +Retorna um `boolean` indicando se a data do objeto `Dayjs` é antes da data fornecida de em outro objeto `Dayjs`. ```js -dayjs().isBefore(Dayjs); dayjs().isBefore(dayjs()); // false ``` -#### Igual +### Igual `.isSame(compared: Dayjs)` -* retorna um Boolean - -Se a data de um objeto `Dayjs` é igual à de outro objeto `Dayjs`. +Retorna um `boolean` indicando se a data do objeto `Dayjs` é a mesma data fornecida de em outro objeto `Dayjs`. ```js -dayjs().isSame(Dayjs); -dayjs().isSame(dayjs()); // true +dayjs().isBefore(dayjs()); // false ``` -#### Depois - -* retorna um Boolean +### Depois `.isAfter(compared: Dayjs)` -Se a data de um objeto `Dayjs` é posterior à de outro objeto `Dayjs`. +Retorna um `boolean` indicando se a data do objeto `Dayjs` é depois da data fornecida de em outro objeto `Dayjs`. ```js -dayjs().isAfter(Dayjs); dayjs().isAfter(dayjs()); // false ``` -### Is a Dayjs `.isDayjs(compared: any)` +### É um objeto `Dayjs` `.isDayjs()` -Returns a `boolean` indicating whether a variable is a dayjs object or not. +Retorna um `boolean` indicando se a variável é um objeto `Dayjs` ou não. ```js dayjs.isDayjs(dayjs()); // true @@ -456,24 +407,24 @@ dayjs.isDayjs(new Date()); // false ### RelativeTime -`.from` `.to` `.fromNow` `.toNow` to get relative time +`.from` `.to` `.fromNow` `.toNow` para obter o tempo relativo plugin [`RelativeTime`](./Plugin.md#relativetime) ### IsLeapYear -`.isLeapYear` to get is a leap year or not +`.isLeapYear` para obter um ano bissexto ou não plugin [`IsLeapYear`](./Plugin.md#isleapyear) ### WeekOfYear -`.week` to get week of the year +`.week` para obter a semana do ano plugin [`WeekOfYear`](./Plugin.md#weekofyear) ### IsBetween -`.isBetween` to check if a date is between two other dates +`.isBetween` para verificar se uma data está entre duas outras datas plugin [`IsBetween`](./Plugin.md#isbetween) diff --git a/docs/pt-br/I18n.md b/docs/pt-br/I18n.md index 1b62b3f62..a49a1de4b 100644 --- a/docs/pt-br/I18n.md +++ b/docs/pt-br/I18n.md @@ -1,13 +1,16 @@ ## Internacionalização -O Day.js tem ótimo suporte para internacionalização. -Mas note que as traduções não serão incluídas no build de seu projeto até você usá-las. É possível usar e trocar entre vários locales (algo como "localizações"). +Day.js possui um ótimo suporte para internacionalização. -Por padrão, Day.js vem com o locale do inglês americano (English (US)). +Porém nenhuma delas estarão incluídas no seu *build* até que você as utilize. + +Por padrão, Day.js vem com o *locale* Inglês (Estados Unidos). + +Você pode carregar múltiplos *locales* e alternar entre eles facilmente. [Lista de locales disponíveis](../../src/locale) -Você está livre para contribuir com a internacionalização deste projeto abrindo uma pull request! :+1: +Você será bem-vindo para adicionar um *locale* abrindo um pull request. :+1: ## API @@ -20,17 +23,17 @@ import 'dayjs/locale/es' import de from 'dayjs/locale/de' dayjs.locale('es') // usar o locale es globalmente dayjs.locale('de-german', de) // usar o locale de e alterar a string padrão -const customizedLocaleObject = { ... } // mais detalhes podem ser vistos na seção de customização abaixo +const customizedLocaleObject = { ... } // mais detalhes podem ser vistos na sessão de customização abaixo dayjs.locale(customizedLocaleObject) // usar locale customizado ``` -* Mudar o locale global não afeta instâncias já existentes. +* Mudar o *locale* global não afeta instâncias já existentes. -#### Mudar locales localmente +#### Mudar *locales* localmente -* Retorna o objeto `Dayjs` usado +* Retorna um novo objeto `Dayjs` para ser substituído por um novo *locale* -Apenas altera o locale de uma instância Dayjs específica. +Exatamente o mesmo que `dayjs#locale`, porém utilizando somente uo *locale* em uma instâcia específica. ```js import 'dayjs/locale/es' @@ -66,26 +69,28 @@ dayjs().locale('es').format() // usar locale em uma instância específica ## Customizar -Você também pode criar seu próprio locale! Sinta-se à vontade para submeter uma pull request depois. +Você pode criar o seu próprio *locale*. + +Sinta-se a vontade para abrir uma pull request e compartilhar sua *locale*. -Template de um objeto de locale do Day.js. +Modelo de um objeto *locale* Day.js. ```javascript const objetoLocale = { - name: 'es', // name: String - weekdays: 'Domingo_Lunes ...'.split('_'), // weekdays: Array - weekdaysShort: 'Sun_M'.split('_'), // OPTIONAL, short weekdays Array, use first three letters if not provided - weekdaysMin: 'Su_Mo'.split('_'), // OPTIONAL, min weekdays Array, use first two letters if not provided - months: 'Enero_Febrero ... '.split('_'), // months: Array - monthsShort: 'Jan_F'.split('_'), // OPTIONAL, short months Array, use first three letters if not provided - ordinal: n => `${n}º`, // ordinal: Function (number) => return number + saída - relativeTime: { // relative time format strings, keep %s %d as the same - future: 'in %s', // e.g. in 2 hours, %s been replaced with 2hours + name: 'es', // nome: String + weekdays: 'Domingo_Lunes ...'.split('_'), // dias da semana: Array + weekdaysShort: 'Sun_M'.split('_'), // OPCIONAL, dias da semana com nome curto: Array, utiliza as três primeiras letras se nenhuma for especificada + weekdaysMin: 'Su_Mo'.split('_'), // OPCIONAL, dias da semana com nome mínimo: Array, utiliza as duas primeiras letras se nenhuma for especificada + months: 'Enero_Febrero ... '.split('_'), // meses: Array + monthsShort: 'Jan_F'.split('_'), // OPCIONAL, meses com nome curto: Array, utiliza as três primeiras letras se nenhuma for especificada + ordinal: n => `${n}º`, // ordinal: Function (number) => retorna number + saída + relativeTime: { // formato relativo de horas, mantém %s %d como o mesmo + future: 'em %s', // exemplo: em 2 horas, %s será substituído por 2 horas past: '%s ago', s: 'a few seconds', m: 'a minute', mm: '%d minutes', h: 'an hour', - hh: '%d hours', // e.g. 2 hours, %d been replaced with 2 + hh: '%d hours', // exemplo: em 2 horas, %s será substituído por 2 d: 'a day', dd: '%d days', M: 'a month', @@ -96,7 +101,7 @@ const objetoLocale = { } ``` -Template de um arquivo de locale do Day.js. +Modelo de um arquivo *locale* do Day.js. ```javascript import dayjs from 'dayjs' diff --git a/docs/pt-br/Installation.md b/docs/pt-br/Installation.md index 049b0e5eb..4fc95a51f 100644 --- a/docs/pt-br/Installation.md +++ b/docs/pt-br/Installation.md @@ -18,13 +18,13 @@ dayjs().format(); * Via CDN: ```html - + ``` -* Via download e self-hosting: +* Via download e *self-hosting*: Simplesmente baixe a última versão do Day.js: [https://unpkg.com/dayjs/](https://unpkg.com/dayjs/) \ No newline at end of file diff --git a/docs/pt-br/Plugin.md b/docs/pt-br/Plugin.md index 340a9c119..e67e1bb04 100644 --- a/docs/pt-br/Plugin.md +++ b/docs/pt-br/Plugin.md @@ -1,10 +1,10 @@ # Lista de Plugins -Um plugin é um módulo independente que pode ser adicionado ao Day.js para estendê-lo com mais funcionalidades. +Um plugin é um módulo independente que pode ser adicionado ao Day.js para estendê-lo ou adicionar novas funcionalidades. -Por padrão, o Day.js vêm apenas com seu código central, sem plugins instalados. +Por padrão, o Day.js vem somente com seu código *core* e sem plugins instalados. -Você pode adicionar vários plugins de acordo com sua necessidade. +Você pode adicionar múltiplos plugins de acordo com a sua necessidade. ## API @@ -12,7 +12,7 @@ Você pode adicionar vários plugins de acordo com sua necessidade. * Retorna objeto Dayjs -Usar um plugin. +Usando um plugin. ```js import plugin @@ -28,13 +28,13 @@ dayjs.extend(plugin, options) // com opções do plugin import dayjs from 'dayjs' import advancedFormat from 'dayjs/plugin/advancedFormat' // carregar sob demanda -dayjs.extend(advancedFormat) // usar plugin +dayjs.extend(advancedFormat) // usa o plugin ``` * Via CDN: ```html - +