Introduction
JDate is a helper class, extended from PHP's DateTime class, which allows developers to handle date formatting more efficiently. The class allows developers to format dates for readable strings, MySQL interaction, UNIX timestamp calculation, and also provides helper methods for working in different timezones.
Використання JDate
Створення екземпляра класу JDate
Всі допоміжні методи дати вимагають примірника класу JDate. Щоб почати, Вам необхідно його створити. Об'єкт JDate може бути створений двома образами. Один - це типовий нативний метод простого створення будь-якого нового примірника:
Ви також можете створити будь-який екземпляр, використовуючи певний в класі JDate статичний метод:
Ніякої різниці між цими методами немає, оскільки JDate :: getInstance просто створює новий екземпляр класу JDate в точності як показаний перший метод.
Альтернативно, Ви можете просто витягти поточну дату (як об'єкт класу JDate) з додатка, використовуючи
Конструктор класу JDate (і статичний метод gedInstance) приймають два опціональних параметра: який-небудь рядок дати для форматування і деяку годинну зону. Відсутність передачі якого-небудь рядка дати створить певний об'єкт класу JDate з поточною датою і часом, в той час як відсутність передачі деякої годинної зони дозволить об'єкту JDate використовувати годинну зону, налаштовану за замовчуванням.
Перший аргумент, якщо ним користуються, повинен бути деякою рядком, яка може бути отримана за допомогою нативного конструктора РНР DateTime. наприклад:
Temporary example of date formats
JFactory :: getDate () gets a JDate object and we then do the JDate toFormat function
В API Joomla 3.3 функція "toFormat" була змінена на "format", так що вище наведений приклад повинен бути:
Function: toISO8601 (boolean $ local = false): string
We set function param before to "false" and after to "true" (user timezone is set to "America / New_York"), we get: