com.stimulsoft.lib.utils

Class StiCalendarUtil

java.lang.Object

com.stimulsoft.lib.utils.StiCalendarUtil

public final class StiCalendarUtil
extends java.lang.Object

Утилитные методы для работы с календарём. Thread-safe.

Method Summary

Methods

Modifier and Type	Method and Description
static java.util.Calendar	calendar(java.util.Date date)
static java.util.Calendar	create(int year, int month, int date)
static java.util.Calendar	dateHi(java.lang.String date) Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в тип Calendar, соответствующий окончанию дня (началу следующего дня).
static java.util.Calendar	dateLo(java.lang.String date) Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в тип Calendar, соответствующий началу дня.
static java.lang.String	format(java.util.Calendar calendar) Преобразует дату в строку формата StiDateUtil.DEFAULT_DATE_PATTERN.
static java.lang.String	format(java.util.Calendar calendar, java.lang.String pattern) Преобразует дату в строку заданного формата.
static java.lang.String	formatEN(java.util.Calendar calendar)
static java.lang.String	formatTime(java.util.Calendar date) Преобразует дату/время в строку формата .
static long	getTimeIntervalInMillis(java.util.Calendar dateFrom, java.util.Calendar dateTo) Возвращает интервал между двумя датами (начальной и конечной) в миллисекундах.
static java.util.Calendar	now()
static java.util.Calendar	parseQuietly(java.lang.String date) Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в дату типа Calendar.
static java.util.Calendar	parseQuietly(java.lang.String date, java.lang.String pattern) Преобразует строку даты в формате format в дату типа Calendar.
static java.util.Calendar	parseTimeQuietly(java.lang.String date) Преобразует строку даты в формате StiDateUtil#DEFAULT_TIME_PATTERN_PATTERN в дату типа Calendar.
static long	subtract(java.util.Calendar dateTime1, java.util.Calendar dateTime2)
static void	synchronizeByFields(java.util.Calendar date1, java.util.Calendar date2, int... fields) Синхронизация дат по заданным полям.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

now

public static java.util.Calendar now()

Returns:

календарь с текущей датой/временем

calendar

public static java.util.Calendar calendar(java.util.Date date)

Parameters:

date - дата

Returns:

календарь с заданным значением даты/времени

parseQuietly

public static java.util.Calendar parseQuietly(java.lang.String date,
                              java.lang.String pattern)

Преобразует строку даты в формате format в дату типа Calendar.

Parameters:

date - дата, которую надо преобразовать

pattern - формат даты параметра

Returns:

преобразованная дата или null в случае ошибки

parseQuietly

public static java.util.Calendar parseQuietly(java.lang.String date)

Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в дату типа Calendar.

Parameters:

date - дата, которую надо преобразовать

Returns:

преобразованная дата или null в случае ошибки

parseTimeQuietly

public static java.util.Calendar parseTimeQuietly(java.lang.String date)

Преобразует строку даты в формате StiDateUtil#DEFAULT_TIME_PATTERN_PATTERN в дату типа Calendar.

Parameters:

date - дата, которую надо преобразовать

Returns:

преобразованная дата или null в случае ошибки

format

public static java.lang.String format(java.util.Calendar calendar,
                      java.lang.String pattern)

Преобразует дату в строку заданного формата.

Parameters:

calendar - дата

pattern - формат для преобразования в строку

Returns:

строка даты

formatEN

public static java.lang.String formatEN(java.util.Calendar calendar)

format

public static java.lang.String format(java.util.Calendar calendar)

Преобразует дату в строку формата StiDateUtil.DEFAULT_DATE_PATTERN.

Parameters:

calendar - дата

Returns:

строка даты

formatTime

public static java.lang.String formatTime(java.util.Calendar date)

Преобразует дату/время в строку формата .

Parameters:

date - дата/время

Returns:

строка времени

dateLo

public static java.util.Calendar dateLo(java.lang.String date)

Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в тип Calendar, соответствующий началу дня.

Parameters:

date - строка даты

Returns:

начало дня

dateHi

public static java.util.Calendar dateHi(java.lang.String date)

Преобразует строку даты в формате StiDateUtil.DEFAULT_DATE_PATTERN в тип Calendar, соответствующий окончанию дня (началу следующего дня).

Parameters:

date - строка даты

Returns:

конец дня

synchronizeByFields

public static void synchronizeByFields(java.util.Calendar date1,
                       java.util.Calendar date2,
                       int... fields)

Синхронизация дат по заданным полям.

Parameters:

date1 - дата, в которую устанавливаются значения

date2 - дата, из которой берутся значения

fields - поля для синхронизации

getTimeIntervalInMillis

public static long getTimeIntervalInMillis(java.util.Calendar dateFrom,
                           java.util.Calendar dateTo)

Возвращает интервал между двумя датами (начальной и конечной) в миллисекундах.

Parameters:

dateFrom - начальная дата

dateTo - конечная дата

Returns:

интервал в миллисекундах

subtract

public static long subtract(java.util.Calendar dateTime1,
            java.util.Calendar dateTime2)

create

public static java.util.Calendar create(int year,
                        int month,
                        int date)