Add Korean locale

Korean locale!! iamkun#171
ujuc · May 29, 2018 · 600e81d · 600e81d
1 parent dc9fc32
commit 600e81d
Show file tree

Hide file tree

Showing 6 changed files with 803 additions and 0 deletions.
diff --git a/docs/ko/API-reference.md b/docs/ko/API-reference.md
@@ -0,0 +1,394 @@
+## API Reference
+
+Day.js는 네이티브 `Date.prototype`을 수정하는 대신 `Dayjs` 오브젝트인 Date 오브젝트 래퍼를 생성합니다.
+
+`Dayjs` 오브젝트는 변경이 불가능(immutable)합니다. 즉, 모든 API 작업은 새로운 `Dayjs` 객체를 반환해야 합니다.
+
+- [API Reference](#api-reference)
+  - [Parsing](#parsing)
+    - [Constructor `dayjs(existing?: string | number | Date | Dayjs)`](#constructor-dayjsexisting-string--number--date--dayjs)
+      - [ISO 8601 string](#iso-8601-string)
+      - [Unix Timestamp (milliseconds since the Unix Epoch - Jan 1 1970, 12AM UTC)](#unix-timestamp-milliseconds-since-the-unix-epoch---jan-1-1970-12am-utc)
+      - [Native Javascript Date object](#native-javascript-date-object)
+    - [Clone `.clone() | dayjs(original: Dayjs)`](#clone-clone-dayjsoriginal-dayjs)
+    - [Validation `.isValid()`](#validation-isvalid)
+  - [Get and Set](#get-and-set)
+    - [Year `.year()`](#year-year)
+    - [Month `.month()`](#month-month)
+    - [Day of the Month `.date()`](#day-of-the-month-date)
+    - [Day of the Week `.day()`](#day-of-the-week-day)
+    - [Hour `.hour()`](#hour-hour)
+    - [Minute `.minute()`](#minute-minute)
+    - [Second `.second()`](#second-second)
+    - [Millisecond `.millisecond()`](#millisecond-millisecond)
+    - [Set `.set(unit: string, value: number)`](#set-setunit-string-value-number)
+  - [Manipulating](#manipulating)
+    - [Add `.add(value: number, unit: string)`](#add-addvalue-number-unit-string)
+    - [Subtract `.subtract(value: number, unit: string)`](#subtract-subtractvalue-number-unit-string)
+    - [Start of Time `.startOf(unit: string)`](#start-of-time-startofunit-string)
+    - [End of Time `.endOf(unit: string)`](#end-of-time-endofunit-string)
+  - [Displaying](#displaying)
+    - [Format `.format(stringWithTokens: string)`](#format-formatstringwithtokens-string)
+      - [List of all available formats](#list-of-all-available-formats)
+    - [Difference `.diff(compared: Dayjs, unit: string (default: 'milliseconds'), float?: boolean)`](#difference-diffcompared-dayjs-unit-string-default-milliseconds-float-boolean)
+    - [Unix Timestamp (milliseconds) `.valueOf()`](#unix-timestamp-milliseconds-valueof)
+    - [Unix Timestamp (seconds) `.unix()`](#unix-timestamp-seconds-unix)
+    - [Days in the Month `.daysInMonth()`](#days-in-the-month-daysinmonth)
+    - [As Javascript Date `.toDate()`](#as-javascript-date-todate)
+    - [As Array `.toArray()`](#as-array-toarray)
+    - [As JSON `.toJSON()`](#as-json-tojson)
+    - [As ISO 8601 String `.toISOString()`](#as-iso-8601-string-toisostring)
+    - [As Object `.toObject()`](#as-object-toobject)
+    - [As String `.toString()`](#as-string-tostring)
+  - [Query](#query)
+    - [Is Before `.isBefore(compared: Dayjs)`](#is-before-isbeforecompared-dayjs)
+    - [Is Same `.isSame(compared: Dayjs)`](#is-same-issamecompared-dayjs)
+    - [Is After `.isAfter(compared: Dayjs)`](#is-after-isaftercompared-dayjs)
+    - [Is Leap Year `.isLeapYear()`](#is-leap-year-isleapyear)
+  - [Plugin APIs](#plugin-apis)
+    - [RelativeTime](#relativetime)
+
+## Parsing
+
+### Constructor `dayjs(existing?: string | number | Date | Dayjs)`
+
+매개 변수없이 호출하면 현재 날짜와 시간을 가진 새로운 `Dayjs` 오브젝트가 반환됩니다.
+
+```js
+dayjs();
+```
+
+Day.js는 다른 날짜 형식도 구분 분석합니다.
+
+#### [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) string
+
+```js
+dayjs('2018-04-04T16:00:00.000Z');
+```
+
+#### Unix Timestamp (milliseconds since the Unix Epoch - Jan 1 1970, 12AM UTC)
+
+```js
+dayjs(1318781876406);
+```
+
+#### Native Javascript Date object
+
+```js
+dayjs(new Date(2018, 8, 18));
+```
+
+### Clone `.clone() | dayjs(original: Dayjs)`
+
+`Dayjs` 클론을 반환합니다.
+
+```js
+dayjs().clone();
+dayjs(dayjs('2019-01-25')); // passing a Dayjs object to a constructor will also clone it
+```
+
+### Validation `.isValid()`
+
+`Dayjs` 날짜가 유효한지 확인하도록 `boolean` 값으로 반환합니다.
+
+```js
+dayjs().isValid();
+```
+
+## Get and Set
+
+### Year `.year()`
+
+`Dayjs`에서 연도를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().year();
+```
+
+### Month `.month()`
+
+`Dayjs`에서 달을 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().month();
+```
+
+### Day of the Month `.date()`
+
+`Dayjs`에서 일자를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().date();
+```
+
+### Day of the Week `.day()`
+
+`Dayjs`에서 주에 대한 일자를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().day();
+```
+
+### Hour `.hour()`
+
+`Dayjs`에서 시를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().hour();
+```
+
+### Minute `.minute()`
+
+`Dayjs`에서 분을 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().minute();
+```
+
+### Second `.second()`
+
+`Dayjs`에서 초를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().second();
+```
+
+### Millisecond `.millisecond()`
+
+`Dayjs`에서 밀리초를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs().millisecond();
+```
+
+### Set `.set(unit: string, value: number)`
+
+적용된 번경사항이 있는 `Dayjs`를 반환합니다.
+
+```js
+dayjs('2000-10-25')
+  .set('month', 3)
+  .set('year', 2020).toString(); // Sat, 25 Apr 2020 00:00:00 GMT
+```
+
+## Manipulating
+
+`Dayjs` 오브젝트는 여러 방법으로 처리할 수 있습니다.
+
+```js
+dayjs('2019-01-25')
+  .add(1, 'day')
+  .subtract(1, 'year').toString(); // Fri, 26 Jan 2018 00:00:00 GMT
+```
+
+### Add `.add(value: number, unit: string)`
+
+특정 시간이 추가하여 복제된 `Dayjs`를 반환합니다. 
+
+```js
+dayjs().add(7, 'day');
+```
+
+### Subtract `.subtract(value: number, unit: string)`
+
+특정 시간이 감소하여 복제된 `Dayjs`를 반환합니다.
+
+```js
+dayjs().subtract(7, 'year');
+```
+
+### Start of Time `.startOf(unit: string)`
+
+특정 시간 단위의 시작 시점에 대한 시간을 복제된 `Dayjs`로 반환합니다.
+
+```js
+dayjs().startOf('week');
+```
+
+### End of Time `.endOf(unit: string)`
+
+특정 시간 단위의 끝나는 시점에 대한 시간을 복제된 `Dayjs`로 반환힙니다.
+
+```js
+dayjs().endOf('month');
+```
+
+## Displaying
+
+### Format `.format(stringWithTokens: string)`
+
+`Dayjs`시간을 기본 형식으로 `string` 타입 값으로 반환합니다.
+예외하고 싶은 문자일 경우, 대괄호나 중괄호를 사용하여 묶으면됩니다. (예, `[G] {um}`)
+
+```js
+dayjs().format(); // 분과 초가 없는 ISO5801 형식의 현재 시간을 나타냅니다. 예: '2020-04-02T08:02:17-05:00'
+
+dayjs('2019-01-25').format('{YYYY} MM-DDTHH:mm:ssZ[Z]'); // '{2019} 01-25T00:00:00-02:00Z'
+
+dayjs('2019-01-25').format('DD/MM/YYYY'); // '25/01/2019'
+```
+
+#### 사용 가능한 모든 형식 목록
+
+| Format | Output           | Description                           |
+| ------ | ---------------- | ------------------------------------- |
+| `YY`   | 18               | 두 자리로 된 연도                      |
+| `YYYY` | 2018             | 네 자리로 된 연도                      |
+| `M`    | 1-12             | 달, 1부터 시작                         |
+| `MM`   | 01-12            | 달, 두 자리로 표현                     |
+| `MMM`  | Jan-Dec          | 월 이름 약어                           |
+| `MMMM` | January-December | 월 이름                               |
+| `D`    | 1-31             | 일                                    |
+| `DD`   | 01-31            | 일, 두 자리로 표현                     |
+| `d`    | 0-6              | 요일, 일요일은 0                       |
+| `dddd` | Sunday-Saturday  | 요일 이름                              |
+| `H`    | 0-23             | 시간                                  |
+| `HH`   | 00-23            | 시간, 두 자리로 표현                   |
+| `h`    | 1-12             | 시간, 12시간                          |
+| `hh`   | 01-12            | 시간, 12시간, 두 자리로 표현           |
+| `m`    | 0-59             | 분                                    |
+| `mm`   | 00-59            | 분, 두 자리로 표현                     |
+| `s`    | 0-59             | 초                                    |
+| `ss`   | 00-59            | 초, 두 자리로 표현                     |
+| `SSS`  | 000-999          | 밀리 초, 3자리로 표현                  |
+| `Z`    | +5:00            | UTC로부터 추가된 시간                  |
+| `ZZ`   | +0500            | UTC로부터 추가된 시간, 두자리로 표현    |
+| `A`    | AM PM            |                                       |
+| `a`    | am pm            |                                       |
+
+* 플러그인 [`AdvancedFormat`](./Plugin.md#advancedformat) 을 사용하면 더 많은 형식 (`Q Do k kk X x ...`)을 사용할 수 있습니다.
+
+### Difference `.diff(compared: Dayjs, unit: string (default: 'milliseconds'), float?: boolean)`
+
+특정 시간을 가르키는 두 `Dayjs`에 대한 차이를 `number` 타입 값으로 반환합니다.
+
+```js
+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 (milliseconds) `.valueOf()`
+
+`Dayjs`에 대한 Unix Epoch 이후의 밀리 초 시간을 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').valueOf(); // 1548381600000
+```
+
+### Unix Timestamp (seconds) `.unix()`
+
+`Dayjs`에 대한 Unix Epoch 이후의 초 시간을 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').unix(); // 1548381600
+```
+
+### Days in the Month `.daysInMonth()`
+
+`Dayjs`에서 표기하는 달에서 일수를 `number` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').daysInMonth(); // 31
+```
+
+### As Javascript Date `.toDate()`
+
+`Dayjs` 오브젝트에서 파싱된 네이티브 `Date` 겍체 복사본을 반환합니다.  
+
+```js
+dayjs('2019-01-25').toDate();
+```
+
+### As Array `.toArray()`
+
+새로운 `Date()`로부터 매개변수를 반영하는 날짜를 `array` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').toArray(); // [ 2019, 0, 25, 0, 0, 0, 0 ]
+```
+
+### As JSON `.toJSON()`
+
+ISO8601 `string` 타입 형식으로 `Dayjs`를 반환합니다.
+
+```js
+dayjs('2019-01-25').toJSON(); // '2019-01-25T02:00:00.000Z'
+```
+
+### As ISO 8601 String `.toISOString()`
+
+
+ISO8601 `string` 타입 형식으로 `Dayjs`를 반환합니다.
+
+```js
+dayjs('2019-01-25').toISOString(); // '2019-01-25T02:00:00.000Z'
+```
+
+### As Object `.toObject()`
+
+날짜 속성을 가진 `object` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').toObject();
+/* { years: 2019,
+     months: 0,
+     date: 25,
+     hours: 0,
+     minutes: 0,
+     seconds: 0,
+     milliseconds: 0 } */
+```
+
+### As String `.toString()`
+
+날짜를 `string` 타입 값으로 반환합니다.
+
+```js
+dayjs('2019-01-25').toString(); // 'Fri, 25 Jan 2019 02:00:00 GMT'
+```
+
+## Query
+
+### Is Before `.isBefore(compared: Dayjs)`
+
+`Dayjs` 값이 다른 `Dayjs` 값보다 앞선 시점인지를 `boolean` 타입 값으로 반환합니다.
+
+```js
+dayjs().isBefore(dayjs()); // false
+```
+
+### Is Same `.isSame(compared: Dayjs)`
+
+`Dayjs` 값이 다른 `Dayjs` 값과 동일한 시점인지를 `boolean` 타입 값으로 반환합니다.
+
+```js
+dayjs().isSame(dayjs()); // true
+```
+
+### Is After `.isAfter(compared: Dayjs)`
+
+`Dayjs` 값이 다른 `Dayjs` 값과 뒷선 시점인지를 `boolean` 타입 값으로 반환합니다.
+
+```js
+dayjs().isAfter(dayjs()); // false
+```
+
+### Is Leap Year `.isLeapYear()`
+
+`Dayjs` 값이 윤년인지를 `boolean` 타입 값으로 반환합니다.
+
+```js
+dayjs('2000-01-01').isLeapYear(); // true
+```
+
+## Plugin APIs
+
+### RelativeTime
+
+`.from` `.to` `.fromNow` `.toNow`에 대한 상대 시간을 가져옵니다.
+
+플러그인 [`RelativeTime`](./Plugin.md#relativetime)