GetUTCMinutes: примеры (JAVASCRIPT)

Работа с минутой по UTC: метод getUTCMinutes
Раздел: Дата и время, UTC методы
getUTCMinutes: number

Описание функции getUTCMinutes

Метод getUTCMinutes() принадлежит объекту Date в JavaScript. Он возвращает минуты указанной даты по всемирному координированному времени (UTC) в виде целого числа от 0 до 59.

Использование функции актуально при работе с международными приложениями, где требуется независимость от локального часового пояса пользователя, например, при логировании событий на сервере, синхронизации времени между разными регионами или работе с API, которые используют UTC.

Функция не принимает никаких аргументов.

Возвращаемое значение — целое число (Integer) от 0 до 59, представляющее минуты указанного объекта Date по UTC.

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

Пример 1: Получение минут из текущей даты и времени.

const now = new Date();
console.log(now.getUTCMinutes());
// Результат зависит от времени выполнения, например: 43

Пример 2: Получение минут из конкретной даты.

const specificDate = new Date('2023-12-31T23:45:00Z');
console.log(specificDate.getUTCMinutes());
45

Пример 3: Использование с нулевыми значениями.

const dateAtZero = new Date('2024-01-01T15:00:00Z');
console.log(dateAtZero.getUTCMinutes());
0

Пример 4: Использование с граничным значением 59 минут.

const dateAt59 = new Date('2024-06-15T12:59:00Z');
console.log(dateAt59.getUTCMinutes());
59

Похожие функции в JavaScript

getMinutes() — возвращает минуты для указанной даты по местному времени. Используется, когда важен часовой пояс пользователя.

getUTCSeconds(), getUTCHours(), getUTCMilliseconds() — возвращают другие компоненты даты по UTC.

Date.prototype.getTime() — возвращает количество миллисекунд с 1 января 1970 года по UTC, что полезно для точных вычислений разницы во времени.

Выбор между getUTCMinutes() и getMinutes() зависит от контекста. Для внутренней логики приложения, связанной с локальным временем пользователя, подходит getMinutes(). Для взаимодействия с сервером, базами данных или международными системами рекомендуется применять методы UTC.

Типичные ошибки

1. Путаница между локальным временем и временем UTC. Это приводит к неверным данным при работе в разных часовых поясах.

const date = new Date();
console.log('Локальные минуты:', date.getMinutes());
console.log('Минуты UTC:', date.getUTCMinutes());
// Результаты могут различаться

2. Попытка передать аргументы. Метод их не принимает, аргументы будут проигнорированы.

const d = new Date();
console.log(d.getUTCMinutes(123)); // Аргумент игнорируется

3. Ожидание строкового возвращаемого значения. Метод возвращает число, поэтому при конкатенации может потребоваться преобразование.

const d = new Date();
const msg = 'Минуты: ' + d.getUTCMinutes(); // Автоматическое преобразование
console.log(msg);
const msg2 = 'Минуты: ' + d.getUTCMinutes().toString().padStart(2, '0'); // Явное форматирование
console.log(msg2);
Минуты: 43
Минуты: 43

Изменения в последних версиях

Метод getUTCMinutes() был стандартизирован в ECMAScript 1 (1997 год) и с тех пор его спецификация остается стабильной, без существенных изменений в поведении или синтаксисе. Он является частью основного стандарта языка и полностью поддерживается во всех современных браузерах и средах выполнения.

Расширенные примеры использования

Пример 1: Форматирование времени UTC в читаемую строку.

Пример javascript
function formatUTCTime(date) {
    const hours = date.getUTCHours().toString().padStart(2, '0');
    const minutes = date.getUTCMinutes().toString().padStart(2, '0');
    const seconds = date.getUTCSeconds().toString().padStart(2, '0');
    return `${hours}:${minutes}:${seconds}`;
}
const now = new Date();
console.log(formatUTCTime(now));
14:43:05

Пример 2: Расчет разницы в минутах между двумя датами по UTC.

Пример javascript
const start = new Date('2024-01-01T10:15:00Z');
const end = new Date('2024-01-01T10:47:30Z');
const diffMs = end - start; // Разница в миллисекундах
const diffMinutes = Math.floor(diffMs / (1000 * 60));
console.log(diffMinutes);
32

Пример 3: Использование в цикле для анализа данных, привязанных ко времени.

Пример javascript
const logEntries = [
    {timestamp: new Date('2024-01-15T08:05:00Z'), event: 'Start'},
    {timestamp: new Date('2024-01-15T08:25:00Z'), event: 'Action'},
    {timestamp: new Date('2024-01-15T08:50:00Z'), event: 'End'}
];
logEntries.forEach(entry => {
    console.log(`Событие "${entry.event}" в ${entry.timestamp.getUTCHours()}:${entry.timestamp.getUTCMinutes().toString().padStart(2,'0')} UTC`);
});
Событие "Start" в 8:05 UTC
Событие "Action" в 8:25 UTC
Событие "End" в 8:50 UTC

Пример 4: Создание массива, содержащего только минуты из массива объектов дат.

Пример javascript
const dates = [
    new Date('2024-03-10T12:10:00Z'),
    new Date('2024-03-10T12:25:00Z'),
    new Date('2024-03-10T12:40:00Z')
];
const minutesArray = dates.map(d => d.getUTCMinutes());
console.log(minutesArray);
[10, 25, 40]

Аналоги функции в других языках

PHP: Функция date('i', $timestamp) с часовым поясом UTC. Отличие: возвращает строку, а не число.

$date = new DateTime('now', new DateTimeZone('UTC'));
echo $date->format('i');
43

Python: Метод datetime.utcnow().minute у объекта datetime. Отличие: объект datetime является неизменяемым.

from datetime import datetime
print(datetime.utcnow().minute)
43

MySQL: Функция EXTRACT(MINUTE FROM UTC_TIMESTAMP()) или MINUTE(UTC_TIME()).

SELECT MINUTE(UTC_TIME());
43

C (стандартная библиотека): Используется структура tm и функция gmtime(). Значение минут хранится в поле tm_min. Отличие: более низкоуровневый подход.

#include 
#include 
int main() {
    time_t t = time(NULL);
    struct tm *utc = gmtime(&t);
    printf("%d", utc->tm_min);
    return 0;
}
43

JS getUTCMinutes function comments

En
GetUTCMinutes Returns the minutes in the specified date according to universal time