Date.toJSON() в JavaScript — дата в рядок ISO

Загальний опис

Метод Date.prototype.toJSON() дозволяє конвертувати об’єкти Date у рядковий формат JSON, забезпечуючи зручний обмін даними між клієнтською та серверною частиною веб-додатків. Метод особливо корисний, коли потрібно відправити дані серверу або зберегти їх у локальному сховищі у форматі, який легко інтерпретується та обробляється.

Date.prototype.toJSON() примінюється для трансформації об'єкта дати у рядок у відповідності до формату JSON, який є ідеальним для передачі даних через HTTP. Для оптимальної роботи цього методу, важливо правильно ініціалізувати дату.

При використанні методу Date.prototype.toJSON(), об'єкт Date конвертується в рядок у форматі ISO 8601, наприклад "2023-09-25T14:15:35Z", що відображає UTC час. Ось приклад використання:

let date = new Date('2023-09-25T14:15:35Z');
console.log(date.toJSON()); // Виведе: "2023-09-25T14:15:35.000Z"

У контексті веб-розробки, основні сфери застосування Date.prototype.toJSON() включають роботу з API, серверами, базами даних, а також для локального зберігання інформації. Метод стає незамінним, коли вам потрібно передавати дані між різними сервісами та платформами, які підтримують формат JSON.

Основною особливістю цього методу є те, що він виводить дату та час у міжнародному форматі, що забезпечує уніфікацію данних, що передаються. Важливо зазначити, що при використанні цього методу немає необхідності у подальшій конвертації чи форматуванні дати, оскільки рядок вже готовий до передачі або зберігання.

Ще одна особливість полягає у тому, що Date.prototype.toJSON() автоматично враховує часові зони та конвертує дату та час до UTC, тому розробникам не потрібно турбуватися про конвертацію часових зон вручну.

правити

Порада

Коли ви працюєте із датами, завжди переконайтеся, що об'єкт Date правильно ініціалізований перед тим, як використовувати toJSON(). Це забезпечить точність і консистентність ваших даних та їх подальшу правильну конвертацію у формат JSON.

автор: Bond правити

Порада

Враховуйте, що метод Date.prototype.toJSON() поверне null, якщо дата недійсна. Отже, завжди враховуйте можливість помилок і підготуйте ваш код до правильної обробки таких ситуацій, щоб забезпечити стабільність та надійність вашого додатку.

let invalidDate = new Date('invalid date');
console.log(invalidDate.toJSON()); // null

автор: Bond правити

Нотатка

Пам'ятайте, що використання Date.prototype.toJSON() дозволяє не тільки отримувати дату у вигляді рядка, але і гарантує, що дата буде у міжнародному форматі та часовій зоні UTC. Це особливо важливо при роботі з міжнародними проєктами або коли вам потрібно передавати дані між різними сервісами та платформами.

автор: Bond правити

Нотатка

Професіоналам можна використовувати Date.prototype.toJSON() у комбінації з іншими API, такими як localStorage або Fetch API, для зберігання або відправки даних, оптимізуючи та уніфікуючи роботу з датами та часом в різних частинах вашого додатку.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

toJSON()

Повернення

string

Повертає рядок, який представляє задану дату в форматі рядка дати та часу згідно з універсальним часом, або null, якщо дата є недійсною. Для дійсних дат значення, що повертається, є таким самим, як і у методі toISOString().

автор: Bond

правити

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	3	1	4	10.5	12	8

Підтримка: мобільні переглядачі

Переглядач
	4.4	18	4	3.2

Підтримка: серверні переглядачі

Переглядач
	0.10.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

// Створення нового об'єкта дати
let currentDate = new Date();

// Використання методу toJSON для отримання рядкового представлення дати у форматі JSON
let jsonDate = currentDate.toJSON();

// Виводимо результат в консоль
console.log(jsonDate);  // Приклад виводу: "2023-09-25T14:36:45.000Z"

// Створення об'єкта дати з конкретною датою
let specificDate = new Date('2023-12-25T12:00:00');

// Перевірка чи дата дійсна
if (!isNaN(specificDate)) {
  // Конвертація дійсної дати в JSON формат
  let jsonSpecificDate = specificDate.toJSON();
  console.log(jsonSpecificDate); // "2023-12-25T12:00:00.000Z"
} else {
  // Вивід повідомлення про помилку, якщо дата недійсна
  console.log('Введено недійсну дату');
}

<header>
  <h2 class="title">Date.prototype.toJSON()</h2>
  <p class="description">Конвертує об'єкт дати в рядок у форматі JSON.</p>
</header>
<main>
  <div class="result">
    <label for="dateInput">Введіть дату: </label>
    <input type="date" id="dateInput" value="2023-09-25">
    <button onclick="convertDateToJSON()">Конвертувати в JSON</button>
    <p id="jsonOutput">Тут буде JSON дата</p>
  </div>
</main>

body {
  font-size: 16px;
  line-height: 1.5;
  font-family: monospace;
}

header {
  background-color: #f1f1f1;
  margin-bottom: 25px;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

header h2.title {
  padding-bottom: 15px;
  border-bottom: 1px solid #999;
}

header p.description {
  font-style: italic;
  color: #222;
}

.result {
  background-color: #f8f8f8;
  padding: 15px;
  -webkit-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  -moz-box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
  box-shadow: 0px 0px 3px 0px rgba(118, 118, 118, 1);
}

function convertDateToJSON() {
  // Отримання введеної дати з поля вводу
  let inputDate = document.getElementById('dateInput').value;

  // Створення об'єкта дати на основі введеної дати
  let selectedDate = new Date(inputDate);

  // Використання методу toJSON для конвертації обраної дати в JSON рядок
  let jsonDate = selectedDate.toJSON();

  // Виведення результату на веб-сторінку
  document.getElementById('jsonOutput').textContent = jsonDate;
}
//# sourceURL=pen.js