JavaScript метод Date.getHours()

Определение и применение

JavaScript метод getHours() возвращает числовое значение (0-23), которое соответствует определенному часу для указанной даты по местному времени.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьjavascript.builtins.Date.getHours
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
getHours✓1✓12✓1✓3✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

JavaScript синтаксис

JavaScript
dateObj.getHours();

Возвращаемое значение и особенности

Возвращается час от 0 до 23 в 24-часовом формате; 0 обозначает полночь.

Метод не принимает параметров и не изменяет объект. Для недействительной даты (Invalid Date) возвращается NaN.

Компонент определяется по местному времени. Для одного момента результат в разных часовых поясах может отличаться. Вариант getUTCHours() читает компонент по UTC.

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

ECMAScript — Date.prototype.getHours(). Метод входит в стандарт начиная с ECMAScript 1.

Примеры, попробуйте сами

Date.getHours() — пример 1

Измените исходные значения и нажмите ▶. Сравните результат с комментариями; местное время определяется часовым поясом браузера.

index.html
HTML
<p>Результат выполнения выводится в консоль.</p>
main.js
JavaScript
// Компоненты конструктора задают местное время; месяцы нумеруются с 0.
const firstDate = new Date(2019, 7, 1, 12, 17, 10)
const secondDate = new Date(2019, 5, 22, 15, 22, 2)

console.log(firstDate.getHours()) // 12
console.log(secondDate.getHours()) // 15

// Для недействительной даты компонент отсутствует.
console.log(new Date(NaN).getHours()) // NaN