Н.А. Вязовик - Программирование на Java

YEAR = 1970, MONTH = JANUARY, DATE = 1 и т.д.

Для считывания и установки различных "частей" даты используются методы get(int field), set(int field, int value), add(int field, int amount), roll(int field, int amount), переменная типа int с именем field указывает на номер поля, с которым нужно произвести операцию. Для удобства все эти поля определены в Calendar как статические константы типа int.

Рассмотрим подробнее порядок выполнения перечисленных методов.

Метод set(int field,int value).

Как уже говорилось, данный метод производит установку какого-либо поля даты. На самом деле после вызова этого метода немедленного пересчета даты не производится. Пересчет даты будет осуществлен только после вызова методов get(), getTime() или getTimeInMillis(). Таким образом, последовательная установка нескольких полей не вызовет ненужных вычислений. Помимо этого, появляется еще один интересный эффект. Рассмотрим следующий пример. Предположим, что дата установлена на последний день августа. Необходимо перевести ее на последний день сентября. Если бы внутреннее представление даты изменялось после вызова метода set, то при последовательной установке полей мы получили бы вот такой эффект:

public class Test {

public Test() {

}

public static void main(String[] args) {

SimpleDateFormat sdf = new SimpleDateFormat("yyyy MMMM dd HH:mm:ss");

Calendar cal = Calendar.getInstance();

cal.set(Calendar.YEAR,2002);

cal.set(Calendar.MONTH,Calendar.AUGUST);

cal.set(Calendar.DAY_OF_MONTH,31);

System.out.println(" Initialy set date: " + sdf.format(cal.getTime()));

cal.set(Calendar.MONTH,Calendar.SEPTEMBER);

System.out.println(" Date with month changed : " + sdf.format(cal.getTime()));

cal.set(Calendar.DAY_OF_MONTH,30);

System.out.println(" Date with day changed : " + sdf.format(cal.getTime()));

}

}

Пример 14.1.

Результатом будет:

Initialy set date: 2002 August 31 22:57:47

Date with month changed : 2002 October 01 22:57:47

Date with day changed : 2002 October 30 22:57:47

Пример 14.2.

Как мы видим, в данном примере при изменении месяца день месяца остался неизменным и было унаследовано его предыдущее значение. Но поскольку в сентябре 30 дней, дата автоматически была переведена на 1 октября, и когда было бы установлено 30 число, оно относилось бы уже к октябрю. В следующем примере считывание даты не производится, соответственно, ее вычисление не выполняется до тех пор, пока все поля не установлены:

public class Test {

public Test() {

}

public static void main(String[] args) {

SimpleDateFormat sdf = new SimpleDateFormat("yyyy MMMM dd HH:mm:ss");

Calendar cal = Calendar.getInstance();

cal.set(Calendar.YEAR,2002);

cal.set(Calendar.MONTH,Calendar.AUGUST);

cal.set(Calendar.DAY_OF_MONTH,31);

System.out.println(" Initialy set date: " + sdf.format(cal.getTime()));

cal.set(Calendar.MONTH,Calendar.SEPTEMBER);

cal.set(Calendar.DAY_OF_MONTH,30);

System.out.println(" Date with day and month changed : " + sdf.format(cal.getTime()));

}

}

Пример 14.3.

Результатом будет:

Initialy set date: 2002 August 31 23:03:51

Date with day and month changed: 2002 September 30 23:03:51

Пример 14.4.

Метод add(int field,int delta).

Добавляет некоторое смещение к существующей величине поля. В принципе, то же самое можно сделать с помощью set(f, get(f) + delta).

В случае использования метода add следует помнить о двух правилах:

1. Если величина поля изменения выходит за диапазон возможных значений данного поля, то производится деление по модулю данной величины, частное суммируется со следующим по старшинству полем.

2. Если изменяется одно из полей, причем, после изменения младшее по отношению к изменяемому полю принимает некорректное значение, то оно изменяется на то, которое максимально близко к "старому".

public class Test {

public Test() {

}

public static void main(String[] args) {

SimpleDateFormat sdf = new SimpleDateFormat("yyyy MMMM dd HH:mm:ss");

Calendar cal = Calendar.getInstance();

cal.set(Calendar.YEAR,2002);

cal.set(Calendar.MONTH,Calendar.AUGUST);

cal.set(Calendar.DAY_OF_MONTH,31);

cal.set(Calendar.HOUR_OF_DAY,19);

cal.set(Calendar.MINUTE,30);

cal.set(Calendar.SECOND,00);

System.out.println("Current date: " + sdf.format(cal.getTime()));

cal.add(Calendar.SECOND,75);

System.out.println("Current date: " + sdf.format(cal.getTime()));

cal.add(Calendar.MONTH,1);

System.out.println("Current date: " + sdf.format(cal.getTime()));

}

}

Пример 14.5.

Результатом будет:

Current date: 2002 August 31 19:30:00

Current date: 2002 August 31 19:31:15

Current date: 2002 September 30 19:31:15

Пример 14.6.

Метод roll(int field,int delta).

Добавляет некоторое смещение к существующей величине поля и не производит изменения старших полей. Рассмотрим приведенный ранее пример, но с использованием метода roll.

public class Test {

public Test() {

}

public static void main(String[] args) {

SimpleDateFormat sdf = new SimpleDateFormat("yyyy MMMM dd HH:mm:ss");

Calendar cal = Calendar.getInstance();

cal.set(Calendar.YEAR,2002);

cal.set(Calendar.MONTH,Calendar.AUGUST);

cal.set(Calendar.DAY_OF_MONTH,31);

cal.set(Calendar.HOUR_OF_DAY,19);

cal.set(Calendar.MINUTE,30);

cal.set(Calendar.SECOND,00);

System.out.println("Current date: " + sdf.format(cal.getTime()));

cal.roll(Calendar.SECOND,75);

System.out.println("Rule 1: " + sdf.format(cal.getTime()));

cal.roll(Calendar.MONTH,1);

System.out.println("Rule 2: " + sdf.format(cal.getTime()));

}

}

Пример 14.7.

Результатом будет:

Current date: 2002 August 31 19:30:00

Rule 1: 2002 August 31 19:30:15

Rule 2: 2002 September 30 19:30:15

Пример 14.8.

Как видно из результатов работы приведенного выше кода, действие правила 1 изменилось по сравнению с методом add, а правило 2 действует так же.

Класс TimeZone

Класс TimeZone предназначен для совместного использования с классами Calendar и DateFormat. Класс абстрактный, поэтому от него порождать объекты нельзя. Вместо этого определен статический метод getDefault(), который возвращает экземпляр наследника TimeZone с настройками, взятыми из операционной системы, под управлением которой работает JVM. Для того, чтобы указать произвольные параметры, можно воспользоваться статическим методом getTimeZone(String ID), в качестве параметра которому передается наименование конкретного временного пояса, для которого необходимо получить объект TimeZone. Набор полей, определяющих возможный набор параметров для getTimeZone, нигде явно не описывается. Вместо этого определен статический метод String[] getAvailableIds(), который возвращает возможные значения для параметра getTimeZone. Так можно определить набор возможных параметров для конкретного временного пояса (рассчитывается относительно Гринвича) String[] getAvailableIds(int offset).

Рассмотрим пример, в котором на консоль последовательно выводятся:

* временная зона по умолчанию;

* список всех возможных временных зон;

* список временных зон, которые совпадают с текущей временной зоной.

public class Test {

public Test() {

}

public static void main(String[] args) {

Test test = new Test();

TimeZone tz = TimeZone.getDefault();

int rawOffset = tz.getRawOffset();

System.out.println("Current TimeZone" + tz.getDisplayName() + tz.getID() + "\n\n");

// Display all available TimeZones

System.out.println("All Available TimeZones \n");

String[] idArr = tz.getAvailableIDs();

for(int cnt=0;cnt < idArr.length;cnt++) {

tz = TimeZone.getTimeZone(idArr[cnt]);

System.out.println(test.padr(tz.getDisplayName() +

tz.getID(),64) + " raw offset=" + tz.getRawOffset() +

";hour offset=(" + tz.getRawOffset()/ (1000 60 60 ) + ")");

}

// Display all available TimeZones same as for Moscow

System.out.println("\n\n TimeZones same as for Moscow \n");

idArr = tz.getAvailableIDs(rawOffset);

for(int cnt=0;cnt < idArr.length;cnt++) {

tz = TimeZone.getTimeZone(idArr[cnt]);

System.out.println(test.padr(tz.getDisplayName()+

tz.getID(),64) + " raw offset=" + tz.getRawOffset() +

";hour offset=(" + tz.getRawOffset()/ (1000 60 60 ) + ")");

}

}

String padr(String str,int len) {

if(len - str.length() > 0) {

char[] buf = new char[len - str.length()];

Arrays.fill(buf,' ');

return str + new String(buf);

} else {

return str.substring(0,len);