recursal/MDN huggingface dataset:
Date.prototype.toISOString()
============================

Сводка
------

Метод **`toISOString()`** возвращает строку в формате ISO (расширенный формат ISO 8601), который можно описать следующим образом: **`YYYY-MM-DDTHH:mm:ss.sssZ`**. Часовой пояс всегда равен UTC, что обозначено суффиксом `"Z"`.

Синтаксис
---------
```

dateObj.toISOString()
```

Примеры
-------

### Пример: использование метода `toISOString()`


```js
var today = new Date("05 October 2011 14:48 UTC");

console.log(today.toISOString()); // вернёт 2011-10-05T14:48:00.000Z
```


Пример выше использует разбор нестандартного строкового значения, которое может разобраться некорректно в браузерах, отличных от Firefox.

Полифил
-------

Этот метод был стандартизирован в ECMA-262 5-го издания. Отсутствие этого метода в движках, которые не были обновлены для его поддержки, можно обойти следующей прокладкой:


```js
if (!Date.prototype.toISOString) {
  (function () {
    function pad(number) {
      if (number < 10) {
        return "0" + number;
      }
      return number;
    }

    Date.prototype.toISOString = function () {
      return (
        this.getUTCFullYear() +
        "-" +
        pad(this.getUTCMonth() + 1) +
        "-" +
        pad(this.getUTCDate()) +
        "T" +
        pad(this.getUTCHours()) +
        ":" +
        pad(this.getUTCMinutes()) +
        ":" +
        pad(this.getUTCSeconds()) +
        "." +
        (this.getUTCMilliseconds() / 1000).toFixed(3).slice(2, 5) +
        "Z"
      );
    };
  })();
}
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.toisostring |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.toLocaleDateString()`
* `Date.prototype.toTimeString()`
* `Date.prototype.toUTCString()`
Date.prototype.toJSON()
=======================

Сводка
------

Метод **`toJSON()`** возвращает представление объекта `Date` в виде JSON.

Синтаксис
---------
```

dateObj.toJSON()
```

Описание
--------

Экземпляры объекта `Date` ссылаются на определённый момент времени. Вызов метода `toJSON()` вернёт строку, отформатированную в JSON (при помощи метода `toISOString()`), представляющую значение объекта `Date`. Этот метод, как правило, предназначен для сериализации объектов `Date` в JSON.

Примеры
-------

### Пример: использование метода `toJSON()`


```js
var jsonDate = new Date().toJSON();
var backToDate = new Date(jsonDate);

console.log("Сериализованный объект даты: " + jsonDate);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.tojson |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.toLocaleDateString()`
* `Date.prototype.toTimeString()`
* `Date.prototype.toUTCString()`
Date.prototype.getUTCDate()
===========================

Сводка
------

Метод **`getUTCDate()`** возвращает день месяца указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.getUTCDate()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getUTCDate()`, является целым числом от 1 до 31.

Примеры
-------

### Пример: использование метода `getUTCDate()`

В следующем примере переменной `day` присваивается значение дня из текущей даты.


```js
var today = new Date();
var day = today.getUTCDate();
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcdate |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getDate()`
* `Date.prototype.getUTCDay()`
* `Date.prototype.setUTCDate()`
Date.prototype.setUTCMonth()
============================

Сводка
------

Метод **`setUTCMonth()`** устанавливает месяц указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.setUTCMonth(monthValue[, dayValue])
```

### Параметры

`monthValue`

Целое число от 0 до 11, представляющее месяцы от января до декабря.

`dayValue`

Необязательный параметр. Целое число от 1 до 31, представляющее день месяца.

Описание
--------

Если вы не определите значения параметра `dayValue`, будет использоваться значение, возвращаемое методом `getUTCDate()`.

Если значение определяемого параметра будет выходить за пределы ожидаемого диапазона, метод `setUTCMonth()` попытается соответственно обновить другой параметр и информацию о дате в объекте `Date`. Например, если в качестве `monthValue` передать значение 15, год увеличится на 1, а в качестве месяца будет использоваться значение 3.

Примеры
-------

### Пример: использование метода `setUTCMonth()`


```js
var theBigDay = new Date();
theBigDay.setUTCMonth(11);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setutcmonth |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCMonth()`
* `Date.prototype.setMonth()`
Date.prototype.getFullYear()
============================

Сводка
------

Метод **`getFullYear()`** возвращает год указанной даты по местному времени.

Используйте этот метод вместо метода `getYear()`.

Синтаксис
---------
```

dateObj.getFullYear()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getFullYear()` является абсолютным числом. Для дат между 1000 и 9999 годом метод `getFullYear()` возвращает четырёхзначный номер, например, 1995. Используйте эту функцию, чтобы быть уверенным, что год будет правильным после 2000 года.

Примеры
-------

### Пример: использование метода `getFullYear()`

В следующем примере переменной `year` присваивается четырёхзначное значение текущего года.


```js
let today = new Date(); // Mon Nov 23 2020 15:23:46 GMT+0300 (Москва, стандартное время)
let year = today.getFullYear(); // 2020
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getfullyear |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCFullYear()`
* `Date.prototype.setFullYear()`
* `Date.prototype.getYear()`
Date.prototype.setUTCSeconds()
==============================

Сводка
------

Метод **`setUTCSeconds()`** устанавливает секунды указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.setUTCSeconds(secondsValue[, msValue])
```

### Параметры

`secondsValue`

Целое число от 0 до 59, представляющее количество секунд.

`msValue`

Необязательный параметр. Число от 0 до 999, представляющее количество миллисекунд.

Описание
--------

Если вы не определите значения параметра `msValue`, будет использоваться значение, возвращаемое методом `getUTCMilliseconds()`.

Если значение определяемого параметра будет выходить за пределы ожидаемого диапазона, метод `setUTCSeconds()` попытается соответственно обновить другой параметр и информацию о дате в объекте `Date`. Например, если в качестве `secondsValue` передать значение 100, минуты увеличатся на 1, а в качестве секунд будет использоваться значение 40.

Примеры
-------

### Пример: использование метода `setUTCSeconds()`


```js
var theBigDay = new Date();
theBigDay.setUTCSeconds(20);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setutcseconds |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCSeconds()`
* `Date.prototype.setSeconds()`
Date.prototype.getMinutes()
===========================

Сводка
------

Метод **`getMinutes()`** возвращает минуты указанной даты по местному времени.

Синтаксис
---------
```

dateObj.getMinutes()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getMinutes()`, является целым числом от 0 до 59.

Примеры
-------

### Пример: использование метода `getMinutes()`

Вторая инструкция в примере ниже присваивает значение 15 переменной `minutes` из значения объекта `Date` `date`.


```js
let date = new Date("December 25, 1995 23:15:30");
let minutes = date.getMinutes();

console.log(minutes); // 15
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getminutes |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCMinutes()`
* `Date.prototype.setMinutes()`
Date.prototype.getDay()
=======================

Сводка
------

Метод **`getDay()`** возвращает порядковый номер дня недели указанной даты по местному времени, где 0 соответствует воскресенью.

Синтаксис
---------
```

dateObj.getDay()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getDay()`, является целым числом, соответствующим дню недели: 0 соответствует воскресенью, 1 — понедельнику, 2 — вторнику и так далее.

Примеры
-------

### Пример: использование метода `getDay()`

Вторая инструкция в примере ниже присваивает значение 1 переменной `weekday` из значения объекта `Date` `date`. 25 декабря 1995 года было понедельником.


```js
let date = new Date("December 25, 1995 23:15:30");
let weekday = date.getDay();

console.log(weekday); // 1
```


**Примечание:** При необходимости полное название дня (например, "`Понедельник`") можно получить, используя `Intl.DateTimeFormat` с параметром `options` parameter. С помощью этого метода упрощается интернационализация:


```js
let options = { weekday: "long" };

console.log(new Intl.DateTimeFormat("en-US", options).format(date));
// Monday

console.log(new Intl.DateTimeFormat("ru-RU", options).format(date));
// понедельник
```


Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getday |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCDate()`
* `Date.prototype.getUTCDay()`
* `Date.prototype.setDate()`
Date.prototype.setHours()
=========================

Сводка
------

Метод **`setHours()`** устанавливает часы указанной даты по местному времени и возвращает количество миллисекунд, прошедших с 1 января 1970 00:00:00 по UTC до времени, представляемого обновлённым экземпляром `Date`.

Синтаксис
---------
```

dateObj.setHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
```

### Версия до JavaScript 1.3
```

dateObj.setHours(hoursValue)
```

### Параметры

`hoursValue`

Целое число от 0 до 23, представляющее часы.

`minutesValue`

Необязательный параметр. Целое число от 0 до 59, представляющее минуты.

`secondsValue`

Необязательный параметр. Целое число от 0 до 59, представляющее секунды. Если вы определите параметр `secondsValue`, вы также должны определить параметр `minutesValue`.

`msValue`

Необязательный параметр. Целое число от 0 до 999, представляющее миллисекунды. Если вы определите параметр `msValue`, вы также должны определить параметры `minutesValue` и `secondsValue`.

Описание
--------

Если вы не определите значения параметров `minutesValue`, `secondsValue` и `msValue`, будут использоваться значения, возвращаемые методами `getMinutes()`, `getSeconds()` и `getMilliseconds()`.

Если значение определяемого параметра будет выходить за пределы ожидаемого диапазона, метод `setHours()` попытается соответственно обновить другие параметры и информацию о дате в объекте `Date`. Например, если в качестве `secondsValue` передать значение 100, минуты увеличатся на 1 (`minutesValue + 1`), а в качестве секунд будет использоваться значение 40.

Примеры
-------

### Пример: использование метода `setHours()`


```js
var theBigDay = new Date();
theBigDay.setHours(7);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.sethours |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getHours()`
* `Date.prototype.setUTCHours()`
Date.prototype.setTime()
========================

Сводка
------

Метод **`setTime()`** устанавливает время объекта `Date` в значение, представляемое количеством миллисекунд, прошедших с 1 января 1970 00:00:00 по UTC.

Синтаксис
---------
```

dateObj.setTime(timeValue)
```

### Параметры

`timeValue`

Целое число, представляющее количеством миллисекунд, прошедших с 1 января 1970 00:00:00 по UTC.

Описание
--------

Используя метод `setTime()`, можно присвоить дату и время другому объекту `Date`.

Примеры
-------

### Пример: использование метода `setTime()`


```js
var theBigDay = new Date("July 1, 1999");
var sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.settime |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getTime()`
* `Date.prototype.setUTCHours()`
Date.prototype.toString()
=========================

Сводка
------

Метод **`toString()`** возвращает строковое представление указанного объекта `Date`.

Синтаксис
---------
```

dateObj.toString()
```

### Параметры

Нет.

Описание
--------

Объект `Date` переопределяет метод `toString()`, унаследованный из объекта `Object`; он не наследует метод `Object.prototype.toString()`. Для объектов `Date` метод `toString()` возвращает строковое представление объекта.

Метод `toString()` всегда возвращает строковое представление даты на американском английском.

JavaScript вызывает метод `toString()` автоматически, когда дата представляется как текст, или когда дата участвует в конкатенации строк.

Примеры
-------

### Пример: использование метода `toString()`

В следующем примере переменной `myVar` присваивается значение, возвращённое методом `toString()` объекта `Date`:


```js
var x = new Date();
myVar = x.toString(); // присваивает переменной myVar значение вроде:
// Mon Sep 28 1998 14:36:22 GMT-0700 (Pacific Daylight Time)
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.tostring |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Object.prototype.toString()`
* `Date.prototype.toDateString()`
* `Date.prototype.toLocaleString()`
* `Date.prototype.toTimeString()`
Date.prototype.setUTCDate()
===========================

Сводка
------

Метод **`setUTCDate()`** устанавливает день месяца указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.setUTCDate(dayValue)
```

### Параметры

`dayValue`

Целое число от 1 до 31, представляющее номер дня в месяце.

Описание
--------

Если значение параметра `dayValue` будет выходить за пределы количества дней для месяца, метод `setUTCDate()` попытается соответственно обновить объект `Date`. Например, если в качестве `dayValue` передать значение 40, а текущий сохранённый в объекте `Date` месяц равен июню, день будет изменён на 10, а месяц увеличится до июля.

Примеры
-------

### Пример: использование метода `setUTCDate()`


```js
var theBigDay = new Date();
theBigDay.setUTCDate(20);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setutcdate |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCDate()`
* `Date.prototype.setDate()`
Date.prototype.getUTCMinutes()
==============================

Сводка
------

Метод **`getUTCMinutes()`** возвращает минуты указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.getUTCMinutes()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getUTCMinutes()`, является целым числом от 0 до 59.

Примеры
-------

### Пример: использование метода `getUTCMinutes()`

В следующем примере переменной `minutes` присваивается количество минут из текущего времени.


```js
var today = new Date();
var minutes = today.getUTCMinutes();
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcminutes |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getMinutes()`
* `Date.prototype.setUTCMinutes()`
Date.prototype.getUTCFullYear()
===============================

Сводка
------

Метод **`getUTCFullYear()`** возвращает год указанной даты по всемирному координированному времени.

Синтаксис
---------
```

dateObj.getUTCFullYear()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getUTCFullYear()` является абсолютным числом, совместимым с проблемой 2000 года, например, 1995.

Примеры
-------

### Пример: использование метода `getUTCFullYear()`

В следующем примере переменной `year` присваивается четырёхзначное значение текущего года.


```js
var today = new Date();
var year = today.getUTCFullYear();
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcfullyear |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getFullYear()`
* `Date.prototype.setFullYear()`
Date.prototype.setUTCHours()
============================

Сводка
------

Метод **`setUTCHours()`** устанавливает часы указанной даты по всемирному координированному времени и возвращает количество миллисекунд, прошедших с 1 января 1970 00:00:00 по UTC до времени, представляемого обновлённым экземпляром `Date`.

Синтаксис
---------
```

dateObj.setUTCHours(hoursValue[, minutesValue[, secondsValue[, msValue]]])
```

### Параметры

`hoursValue`

Целое число от 0 до 23, представляющее часы.

`minutesValue`

Необязательный параметр. Целое число от 0 до 59, представляющее минуты.

`secondsValue`

Необязательный параметр. Целое число от 0 до 59, представляющее секунды. Если вы определите параметр `secondsValue`, вы также должны определить параметр `minutesValue`.

`msValue`

Необязательный параметр. Целое число от 0 до 999, представляющее миллисекунды. Если вы определите параметр `msValue`, вы также должны определить параметры `minutesValue` и `secondsValue`.

Описание
--------

Если вы не определите значения параметров `minutesValue`, `secondsValue` и `msValue`, будут использоваться значения, возвращаемые методами `getUTCMinutes()`, `getUTCSeconds()` и `getUTCMilliseconds()`.

Если значение определяемого параметра будет выходить за пределы ожидаемого диапазона, метод `setUTCHours()` попытается соответственно обновить другие параметры и информацию о дате в объекте `Date`. Например, если в качестве `secondsValue` передать значение 100, минуты увеличатся на 1 (`minutesValue + 1`), а в качестве секунд будет использоваться значение 40.

Примеры
-------

### Пример: использование метода `setUTCHours()`


```js
var theBigDay = new Date();
theBigDay.setUTCHours(8);
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.setutchours |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCHours()`
* `Date.prototype.setHours()`
Date.now()
==========

Сводка
------

Метод **`Date.now()`** возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC.

Синтаксис
---------
```

var timeInMs = Date.now();
```

### Параметры

Нет.

Описание
--------

Метод `now()` возвращает количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC по текущий момент времени в качестве числа.

Поскольку метод `now()` является статическим методом объекта `Date`, вы всегда должны использовать его как `Date.now()`.

Полифил
-------

Этот метод был стандартизирован в ECMA-262 5-го издания. Отсутствие этого метода в движках, которые не были обновлены для его поддержки, можно обойти следующей прокладкой:


```js
if (!Date.now) {
  Date.now = function now() {
    return new Date().getTime();
  };
}
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.now |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Performance.now()` — предоставляет временные метки с разрешением в доли миллисекунд для использования при измерении производительности веб-страницы
* `console.time()` / `console.timeEnd()`
Date.prototype.getUTCDay()
==========================

Сводка
------

Метод **`getUTCDay()`** возвращает день недели указанной даты по всемирному координированному времени, где 0 соответствует воскресенью.

Синтаксис
---------
```

dateObj.getUTCDay()
```

### Параметры

Нет.

### Возвращаемое значение

Значение, возвращённое методом `getDay()`, является целым числом, соответствующим дню недели: 0 соответствует воскресенью, 1 — понедельнику, 2 — вторнику и так далее.

Примеры
-------

### Пример: использование метода `getUTCDay()`

В следующем примере переменной `weekday` присваивается номер дня недели из текущей даты.


```js
var today = new Date();
var weekday = today.getUTCDay();
```

Спецификации
------------

| Specification |
| --- |
| ECMAScript Language Specification # sec-date.prototype.getutcday |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `Date.prototype.getUTCDate()`
* `Date.prototype.getDay()`
* `Date.prototype.setUTCDate()`