Форматування дати в Java

В Java є зручний клас SimpleDateFormat, який можна використовувати для форматування дати. В цій статті Ви знайдете огляд парметрів, які приймає методи класу SimpleDateFormat, а також будуть приведені результати виконання методу format з різноманітними параметрами.

Наведемо простий приклад форматування дати з використанням класу SimpleDateFormat:

import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;

/**
 *
 * @author seostella.com
 */
public class SimpleDateFormatExample {

    public static void main(String[] args) {
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy.MM.dd G 'at' HH:mm:ss z");
        System.out.println("date: " + dateFormat.format( new Date() ) );
    }
}

Якщо на комп'ютері локалізацією за умовчанням є російська локалізація, то в результаті виконання наведеного коду Ви побачите наступне:

date: 2012.02.07 н.э. at 15:13:08 EET

Розглянемо деякі методи класу SimpleDateFormat. Для початку, клас має 4 конструктора:

SimpleDateFormat()
  // Створює SimpleDateFormat, використовуючи патерн часу і формат символів за замовчуванням для поточної локалізації
SimpleDateFormat(String pattern)
  // Створює SimpleDateFormat, використовуючи заданий патерн часу і формат символів за замовчуванням для поточної локалізації
SimpleDateFormat(String pattern, DateFormatSymbols formatSymbols)
  // Створює SimpleDateFormat, використовуючи задані патерн часу і формат символів
SimpleDateFormat(String pattern, Locale locale)
  // Створює SimpleDateFormat, використовуючи заданий патерн часу і формат символів за замовчуванням для заданої локалізації

Наступний приклад демонструє роботу всіх чотирьох конструкторів:

package simpledateformatexample;

import java.text.DateFormatSymbols;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
/**
 *
 * @author seostella.com
 */
public class SimpleDateFormatExample {

    public static void main(String[] args) {
        Date currentDate = new Date();
        SimpleDateFormat dateFormat = null;
        
        dateFormat = new SimpleDateFormat();
        System.out.println("Constructor 1: " + dateFormat.format( currentDate ) );
        
        dateFormat = new SimpleDateFormat("dd MMMM");
        System.out.println("Constructor 2: " + dateFormat.format( currentDate ) );
        
        dateFormat = new SimpleDateFormat("dd MMMM", myDateFormatSymbols );
        System.out.println("Constructor 3: " + dateFormat.format( currentDate ) );
        
        dateFormat = new SimpleDateFormat("dd MMMM", Locale.ENGLISH);
        System.out.println("Constructor 4: " + dateFormat.format( currentDate ) );
    }
    
    private static DateFormatSymbols myDateFormatSymbols = new DateFormatSymbols(){

        @Override
        public String[] getMonths() {
            return new String[]{"января", "февраля", "марта", "апреля", "мая", "июня",
                "июля", "августа", "сентября", "октября", "ноября", "декабря"};
        }
        
    };
}

Результатом виконання цього коду будуть наступні чотири рядки:

Constructor 1: 07.02.12 15:34
Constructor 2: 07 Февраль
Constructor 3: 07 февраля
Constructor 4: 07 February

Конструктор за замовчуванням використовує паттерн часу і формат символів за замовчуванням для поточної локалізації. Тобто, для російської локалізації стандартним паттерном часу є патерн "dd.MM.yy HH:mm".

Конструктор SimpleDateFormat(String pattern) приймає патерн дати, в якому буде віддавати результат метод format(). У прикладі ми використовували патерн "dd MMMM", який вимагає від format() вивести дату в наступному форматі: "дві цифри дня місяця" + "пробіл" + "назва місяця". В даному випадку використовується назва місяця за замовчуванням для поточної локалізації, тобто, "Февраль".

Конструктор SimpleDateFormat("dd MMMM", myDateFormatSymbols ) аналогічний попередньому за винятком того, що назва місяця використовується не за замовчуванням, а та, яка повертається змінною myDateFormatSymbols. У свою чергу, в змінній myDateFormatSymbols ми перевизначили метод getMonths() щоб він повертав назви місяців з великої букви і в родовому відмінку.

Конструктор SimpleDateFormat("dd MMMM", Locale.ENGLISH) аналогічний конструктору SimpleDateFormat(String pattern), але використовує задану локалізацію. В нашому випадку це англійська локалізація Locale.ENGLISH.

Розглянемо докладно параметри, які приймаєі клас SimpleDateFormat в якості патерну дати.

Розглянемо кілька прикладів паттернів дати і часу, які представлені в офіційній документації. Російська локалізація:

Англійська локалізація: