三、方法说明

1、常规方法

getYear

功能：获取年份
参数：无
返回值：返回年份
返回数据类型：Number
用法：

const newData = new Wdate()
console.log(newData.getYear()) // 2022

getMonth

功能：获取月份
Параметр：(isFillZero) | 参数名 | 参数类型 | 参数默认值 | 参数说明 | | ---------- | -------- | ---------- | ----------------------- | | isFillZero | Boolean | false | 是否补0，小于10前边补零 |
Возвращаемое значение：возвращает месяц 1-12|01-12
Тип возвращаемых данных：Number|String
Использование：

const newData = new Wdate('2022-01-27 13:05:03')
console.log(newData.getMonth()) // 1
console.log(newData.getMonth(true)) // 01

getDate

Функциональность：получить день месяца
Параметры：(isFillZero) | 参数名 | 参数类型 | 参数默认值 | 参数说明 | | ---------- | -------- | ---------- | ----------------------- | | isFillZero | Boolean | false | 是否补0，小于10前边补零 |
Возвращаемое значение：вернуть день месяца 1-31|01-31
Тип возвращаемого значения：Number|String
Применение：

const newData = new Wdate('2022-01-27 13:05:03')
console.log(newData.getDate()) // 27
console.log(newData.getDate(true)) //27

getHours

Функционал：получение часов
Параметры：(isFillZero, isTwentyFour) | 参数名 | 参数类型 | 参数默认值 | 参数说明 | | ------------ | -------- | ---------- | ----------------------- | | isFillZero | Boolean | false | 是否补0，小于10前边补零 | | isTwentyFour | Boolean | true | 是否是24小时制 |
Возвращаемое значение：вернет часы 0-24|00-24, если 12-часовой формат, то вернет 0-12|00-12
Тип возвращаемого значения：Number|String
Использование：

const newData = new Wdate() // текущая дата 2022 год 1 месяц 27 день 13:05:03
console.log(newData.getHours()) // 13 24-часовая система
console.log(newData.getHours(false,false)) //1 12-часовая система без заполнения нулями
console.log(newData.getHours(true,false)) //01 12-часовая система с заполнением нулей

getMinutes

Функция：получить минуты
Параметры：(isFillZero) | 参数名 | 参数类型 | 参数默认值 | 参数说明 | | ---------- | -------- | ---------- | ----------------------- | | isFillZero | Boolean | false | 是否补0，小于10前边补零 |
Возвращаемое значение：минуты 0-59|00-59
Тип возвращаемого значения：Number|String
Использование：

const newData = new Wdate() // текущая дата 2022 год 1 месяц 27 день 13:05:03
console.log(newData.getMinutes()) // 5
console.log(newData.getMinutes(true)) // 05 не хватает 10, добавить 0

getSeconds

Функция：получить секунды
Параметры：(isFillZero) | 参数名 | 参数类型 | 参数默认值 | 参数说明 | | ---------- | -------- | ---------- | --------------------------- | | isFillZero | Boolean | false | 是否补0，天数小于10前边补零 |
Возвращаемое значение：секунды 0-59|00-59
Тип возвращаемого значения：Number|String
Использование：

const newData =
``` ### getAge

- **Функция**: получение возраста.

- **Параметры**: отсутствуют.

- **Возвращаемое значение**: неотрицательное целое число.

- **Тип возвращаемых данных**: `Number`.

- **Использование**:

  ```javascript
  const newData = new Wdate('1992-04-24') 
  console.log(newData.getAge()) // 29
  
  const newData = new Wdate('1992-01-01') 
  console.log(newData.getAge()) // 30

Примечание: экземпляр даты не может быть больше текущей даты.

getCconstellation

Функция: определение созвездия.
Параметры: отсутствуют.
Возвращаемое значение: одно из 12 созвездий: «Овен», «Телец», «Близнецы», «Рак», «Лев», «Дева», «Весы», «Скорпион», «Стрелец», «Козерог», «Водолей» или «Рыбы».
Тип возвращаемых данных: String.
Таблица соответствия созвездий и дат: | ID | Созвездие | Соответствующая дата | |----|-----------|---------------------| | 1 | Водолей | 1.20 — 2.18 | | 2 | Рыбы | 2.19 — 3.20 | | 3 | Овен | 3.21 — 4.19 | | 4 | Телец | 4.20 — 5.20 | | 5 | Близнецы | 5.21 — 6.21 | | 6 | Рак | 6.22 — 7.22 | | 7 | Лев | 7.23 — 8.22 | | 8 | Дева | 8.23 — 9.22 | | 9 | Весы | 9.23 — 10.23 | | 10 | Скорпион | 10.24 — 11.22 | | 11 | Стрелец | 11.23 — 12.21 | | 12 | Козерог | 12.22 — 1.19 |
Применение:

const newData = new Wdate('1992-2-22')
console.log(newData.getCconstellation()) // Близнецы

getDayOfYear

Функция: возвращает количество дней в текущем году.
Параметры: отсутствуют.
Возвращаемое значение: от 1 до 366.
Тип возвращаемых данных: Number.

Пример использования:

const newData = new Wdate('2022-01-05')
console.log(newData.getDayOfYear()) // 5

getAdd

Функция: возврат новой даты с учётом увеличения времени на определённый срок.
Параметры: (size, unit, formart).

Параметр format передаётся со значением согласно методу форматирования данных.

Параметр	Тип параметра	Значение по умолчанию	Описание
size	Number	0/ Если значение отрицательное, то используется метод getSubtract	Размер
unit	String	date	Тип
formart	String	yy-MM-dd HH:mm:ss	Формат

Описание параметра unit:

ID	Значение параметра	Сокращение	Описание
1	year	y	Год
2	month	M(заглавная)	Месяц
3	date	d	День
4	hour	H(заглавная)	Час
5	minute	m	Минута
6	second	s	Секунда
7	millisecond	ms	Миллисекунда
8	quarter	Q(заглавная)	Квартал
9	week	w	Неделя

Возвращаемое значение: форматированная дата.
Тип возвращаемого значения: String.

Примеры использования:

console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'year') // 2023-02-22 12:12:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'month')) // 2022-04-22 12:12:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'date')) // 2022-02-23 12:12:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'hour')) // 2022-02-22 13:12:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'minute')) // 2022-02-22 12:13:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'second')) // 2022-02-22 12:12:13
console.log(new Wdate('2022-02-22 12:12:12').getAdd(2000, 'millisecond')) // 2022-02-22 12:12:14
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'quarter')) // 2022-06-22 12:12:12
console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'week')) // 2022-03-01 12:12:12

getSubtract

Функция: возвращение новой даты после уменьшения времени на определённое количество единиц.
Параметры: (size, unit, formart).

Параметр format передаётся со значением согласно методу форматирования данных.

Параметр	Тип параметра	Значение по умолчанию	Описание
size	Number	0/ Если значение отрицательное, то используется метод getAdd	Размер
unit	String	date	Тип
formart	String	yy-MM-dd HH:mm:ss	Формат

Описание параметра unit:

ID	Значение параметра	Сокращение	Описание
1	year	y	Год
2	month	M(заглавная)	Месяц
3	date	d	День
4	hour	H(заглавная)	Час
5	minute	m	Минута
6	second	s	Секунда
7	millisecond	ms	Миллисекунда
8	quarter	Q(заглавная)	Квартал
9	week	w	Неделя

Возвращаемое значение: форматированная дата.
Тип возвращаемого значения: String.
Примеры использования:
```
console.log(new
```

В запросе есть код на языке JavaScript, но он не содержит ошибок и не требует перевода. ``` Wdate('2022-02-22 12:12:12').getAdd(10)) //2022-03-04 12:12:12

// Передача параметров в режиме «передать параметр» console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'year')) // 2021-02-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'month')) // 2022-01-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'date')) // 2022-02-21 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'hour')) // 2022-02-22 11:12:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'minute')) // 2022-02-22 12:11:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'second')) // 2022-02-22 12:12:11 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(2000, 'millisecond')) // 2022-02-22 12:12:10 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'quarter')) // 2021-11-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getSubtract(1, 'week')) // 2022-02-15 12:12:12

// Режим сокращения console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'y')) // 2023-02-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'M')) // 2022-04-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'd')) // 2022-02-23 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'H')) // 2022-02-22 13:12:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'm')) // 2022-02-22 12:13:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 's')) // 2022-02-22 12:12:13 console.log(new Wdate('2022-02-22 12:12:12').getAdd(2000, 'ms')) // 2022-02-22 12:12:14 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'Q')) // 2022-06-22 12:12:12 console.log(new Wdate('2022-02-22 12:12:12').getAdd(1, 'w')) // 2022-03-01 12:12:12

// getDateDiff function getDateDiff(dateTime) { return { day: 0, // 总天数 hours: 15, hoursCount: 15, // 总小时 minutes: 30, seconds: 30, timestamp: -55830000 // 结果为负数 }; }

console.log(getDateDiff('2022-03-03 12:00:00')); console.log(getDateDiff('2022-03-04 03:30:30'));

// getDiffDay function getDiffDay(dateTime) { return 0; }

console.log(getDiffDay()); console.log(getDiffDay('2022-03-03 12:00:00')); console.log(getDiffDay('2022-03-04 03:30:30'));

// 格式化数据方法 function getTimeFrame(hour, text) { return 'PM'; }

const newData = new Date();

console.log(getTimeFrame());

['2022', '03', '08', '10', '16', '19', '112']


**toJSON**  

* Функционал: сериализация в формат ISO 8601.  
* Параметры: отсутствуют.  
* Возвращаемое значение: строка в формате сериализации.  
* Тип возвращаемого значения: String.  
* Использование:  

```javascript
console.log(new Wdate().toJSON()) // 2022-03-08T02:11:18.764Z

toObject

Функционал: возвращает объект, содержащий информацию о времени.
Параметр: (isFillZero)
| Параметр | Тип параметра | Значение по умолчанию | Описание | | --- | --- | --- | --- | | isFillZero | Boolean | false | Заполнять нулями или нет |
Возвращаемое значение:

{
    year: 2022, // год
    month: 1, // месяц
    date: 27, // день
    hours: 14, // часы
    minutes: 46, // минуты
    seconds: 29, // секунды
    timestamp: 1643265989971 // временная метка в миллисекундах
}

Тип возвращаемого значения: Object.
Использование:

console.log(new Wdate(1646705779112).toObject(true)) // заполнение нулями, все значения возвращаются в виде строк
console.log(new Wdate(1646705779112).toObject()) // по умолчанию не заполняется нулями, все значения возвращаются как числа

7. Методы установки

Все методы с префиксом set поддерживают цепное использование. Если размер передаётся неверно, будет выброшено исключение Error('размер параметра неверный').

Пример:

console.log(new Wdate('2022-03-08 12:12:12').set(2,'d').getFormat()) // 2022-03-02 12:12:12
console.log(new Wdate('2022-03-08 12:12:12').set(2020,'y').getFormat('преобразует 2022 год в: yy')) // преобразует 2022 год в: 2020
console.log(new WDate('2022-03-08 12:12:12').setYear(2020).getYear()) // 2022

setYear

Функциональность: устанавливает год даты.
Параметр: year
| Параметр | Тип параметра | Значение по умолчанию | Описание | | --- | --- | --- | --- | | year | Number | 0 | Год (год должен быть между 1970 и 2200) |
Использование:

const newData = new Wdate('2022-03-08 12:12:12')
newData.setYear(2020)
console.log(newData.getYear()) // 2020

setMonth

Функциональность: устанавливает месяц даты.
Параметр: month
| Параметр | Тип параметра | Значение по умолчанию | Описание | | --- | --- | --- | --- | | month | Number | 0 | Месяц (ожидается значение от 1 до 12, но допускаются и другие значения: 0 приведёт к последнему месяцу предыдущего года, 13 — к первому месяцу следующего года) |
Использование:

console.log(new Wdate('2022-03-08 12:12:12').setMonth(2).getFormat()) // 2022-02-08 12:12:12
console.log(new Wdate('2022-03-08 12:12:12').setMonth(-1).getFormat()) // 2021-11-08 12:12:12 последний месяц предыдущего года
console.log(new Wdate('2022-03-08 12:12:12').setMonth(13).getFormat()) // 2023-01-08 12:12:12 первый месяц следующего года

setDate

Функциональность: устанавливает день месяца для даты.
Параметр: day
| Параметр | Тип параметра | Значение по умолчанию | Описание | | --- | --- | --- | --- | | day | Number | 0 | Обязательный параметр. Целое число, представляющее день месяца. Ожидается значение от 1 до 31, но допустимы и другие значения. 0 приведёт к последнему дню предыдущего месяца, -1 — к предпоследнему дню предыдущего месяца |
Использование:

console.log(new Wdate('2022-03-08 12:12:12').setDate(20).getFormat()) // 2022-03-20 12:12:12
// 0 приведёт к последнему дню предыдущего месяца
console.log(new Wdate('2022-03-08 127:12:12').setDate(0).getFormat()) // 2022-02-28 12:12:12
// -1 приведёт к предпоследнему дню предыдущего месяца
console.log(new Wdate('2022-03-08 12:12:12').setDate(-1).getFormat()) // 2022-02-27 12:12:12
``` |  | 8 | quarter | Q(大写) | последний день третьего месяца текущего квартала в 23:59:59 |
| --- | --- | --- | --- | --- |
|  | 9 | week | w | последний день текущей недели в 23:59:59 (воскресенье — первый день недели) |
|  | 10 | weekMonday | wm | последний день текущей недели в 23:59:59 (понедельник — первый день недели)|

**Использование**
```javascript
const dateTime = 1646819487333 // "2022-03-06 12:22:32 333"
console.log(new Wdate(dateTime).getFormat('yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('y').getFormat('年：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('M').getFormat('月：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('d').getFormat('日：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('Q').getFormat('季：yy-MM-dd HH:mm:ss 毫秒ms 星期wwQ'))
console.log(new Wdate(dateTime).setEndOf('H').getFormat('时：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('m').getFormat('分：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('s').getFormat('秒：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('w').getFormat('周【周六为最后一天】：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))
console.log(new Wdate(dateTime).setEndOf('wm').getFormat('周【周日为最后一天】：yy-MM-dd HH:mm:ss 毫秒ms 星期ww'))

// 2022-03-09 17:51:27 毫秒333 星期三
// 年：2022-12-31 23:59:59 毫秒999 星期六
// 月：2022-03-31 23:59:59 毫秒999 星期四
// 日：2022-03-09 23:59:59 毫秒999 星期三
// 季：2022-03-31 23:59:59 毫秒999 星期四Q
// 时：2022-03-09 17:59:59 毫秒999 星期三
// 分：2022-03-09 17:51:59 毫秒999 星期三
// 秒：2022-03-09 17:51:27 毫秒999 星期三
// 周【周六为最后一天】：2022-03-12 23:59:59 毫秒999 星期六
// 周【周日为最后一天】：2022-03-13 23:59:59 毫秒999 星期日

Четыре. Версия обновления записи

V1.0.4

Добавлены следующие методы: isAfter() — определяет, находится ли дата до указанной даты; isSame() — сравнивает дату с указанной датой; isBefore() — определяет, находится ли дата после указанной даты; isValid() — проверяет, является ли переданная дата допустимой; getQuarter() — получает квартал.

V1.0.5

Добавлены следующие методы: getLunarZodiac() — получает знак зодиака по году; getLunar() — получает информацию о дате по лунному календарю; getAge() — получает возраст; getCconstellation() — получает созвездие по знаку зодиака.

V1.0.6

Убраны логи консоли console.log; исправлена документация; добавлены следующие методы: isToday() — определяет, является ли дата текущей; isThisYear() — определяет, относится ли дата к текущему году; isThisMonth() — определяет, относится ли дата к текущему месяцу; isThisWeek() — определяет, относится ли дата к текущей неделе; isWorkday() — определяет, рабочий это день или выходной; getDayOfYear() — возвращает порядковый номер дня в году.

V1.0.7

Исправлена документация; изменено getFormatOne на getFormat; код оптимизирован.

V1.0.8

Изменён метод getAllDateTime на getFormat; добавились следующие методы: isBetween() — определяет, попадает ли время во временной интервал; get() — возвращает год, месяц, день, час, минуту, секунду и миллисекунду; getAdd() — возвращает новую дату с добавленными днями; getDateDiff() — информация о разнице между датами; getDiffDay() — разница между датами в днях; toString() — возвращает строку с информацией о времени; toArray() — преобразует дату в массив; toJSON() — сериализует дату в формат ISO 8601; toObject() — преобразует дату в объект; setYear() — устанавливает год; setMonth() — устанавливает месяц; setDate() — устанавливает день месяца; setHours() — устанавливает часы; setMinutes() — устанавливает минуты; setSeconds() — устанавливает секунды; setMilliseconds() — устанавливает миллисекунды; set() — устанавливает год, месяц, день, час, минуту, секунду и миллисекунду.

OSCHINA-MIRROR/wanghuilife-wdx-date

三、方法说明

1、常规方法

getYear

getMonth

getDate

getHours

getMinutes

getSeconds

getCconstellation

getDayOfYear

getAdd

getSubtract

Четыре. Версия обновления записи

V1.0.4

V1.0.5

V1.0.6

V1.0.7

V1.0.8

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/wanghuilife-wdx-date .gitee-modal { min-width: 500px !important; } .gitee-modal .close { right: 0.6rem !important; }

三、方法说明

1、常规方法

getYear

getMonth

getDate

getHours

getMinutes

getSeconds

getCconstellation

getDayOfYear

getAdd

getSubtract

Четыре. Версия обновления записи

V1.0.4

V1.0.5

V1.0.6

V1.0.7

V1.0.8

Опубликовать ( 0 )

Введение

Обновления

Участники

Недавние действия

OSCHINA-MIRROR/wanghuilife-wdx-date