com.telerik.widget.calendar

Class CalendarTools

java.lang.Object

com.telerik.widget.calendar.CalendarTools

public class CalendarTools
extends Object

Contains methods which ease life while working with dates.

Constructor Summary

Constructors

Constructor and Description
CalendarTools()

Method Summary

Modifier and Type	Method and Description
static long	calculateNewValue(boolean valueIncreases, long firstDateToDisplay, CalendarDisplayMode displayMode) Calculates a new date value based on the given first day to display and the current display mode of the calendar.
static long	getDateEnd(long date)
static long	getDateStart(long date) Gets a Long that represents the first date in the month that contains the provided date.
static long	getFirstDateInMonth(long date) Gets a Long that represents the first date in the month that contains the provided date.
static long	getFirstDateInWeek(long date)
static long	getFirstDateInYear(long date)
static long	getFirstDateOfWeekWith(Long date) Gets a Long representing the first date of the week that contains the specified displayed date in accordance with the specified calendar.
static long	getFirstDisplayDate(Long displayDate) Gets a Long that represents the first date that should be displayed in a month that contains the displayed date in accordance with the specified calendar.
static long	getFirstMonthInYear(long date)
static long	getLastDateInMonth(long displayDate)
static long	getLastDateInWeek(long date)
static long	getLastDateInYear(long date)
static long	getLastMonthInYear(long displayDate)
static String	getShortDayName(int day) Gets a String which represent the short name of the day with the specified index in accordance with the first day of the week determined by the locale and in the language that it represents.
static boolean	isWeekend(long date)

Methods inherited from class java.lang.Object

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

Constructor Detail

CalendarTools

public CalendarTools()

Method Detail

getDateStart

public static long getDateStart(long date)

Gets a Long that represents the first date in the month that contains the provided date.

Parameters:

date - the date

Returns:

the first date of the month that contains the display date

isWeekend

public static boolean isWeekend(long date)

getDateEnd

public static long getDateEnd(long date)

getFirstDateInMonth

public static long getFirstDateInMonth(long date)

Gets a Long that represents the first date in the month that contains the provided date.

Parameters:

date - the date

Returns:

the first date of the month that contains the display date

getFirstDateInWeek

public static long getFirstDateInWeek(long date)

getFirstDateInYear

public static long getFirstDateInYear(long date)

getFirstMonthInYear

public static long getFirstMonthInYear(long date)

calculateNewValue

public static long calculateNewValue(boolean valueIncreases,
                                     long firstDateToDisplay,
                                     CalendarDisplayMode displayMode)

Calculates a new date value based on the given first day to display and the current display mode of the calendar.

Parameters:

valueIncreases - the new value will be bigger if true and smaller if false

firstDateToDisplay - the date from which to calculate the new value.

Returns:

the new value

getFirstDisplayDate

public static long getFirstDisplayDate(Long displayDate)

Gets a Long that represents the first date that should be displayed in a month that contains the displayed date in accordance with the specified calendar. For example, if the display date is Tuesday, 1st of February and according to the specified calendar the first day of the week is Sunday, the returned value will be the date that was on Sunday on the week that contains the displayed date. In the example, that is 30th of January.

Parameters:

displayDate - the display date

Returns:

the first date that will be visible on a calendar that shows the specified display date

getFirstDateOfWeekWith

public static long getFirstDateOfWeekWith(Long date)

Gets a Long representing the first date of the week that contains the specified displayed date in accordance with the specified calendar. For example, if the display date is Tuesday, 1st of February and according to the specified calendar the first day of the week is Sunday, the returned value will be the date that was on Sunday on the week that contains the displayed date. In the example, that is 30th of January.

Parameters:

date - the date

Returns:

the first date of the week that contains the provided date

getShortDayName

public static String getShortDayName(int day)

Gets a String which represent the short name of the day with the specified index in accordance with the first day of the week determined by the locale and in the language that it represents. For example, if the locale is en, this means that the language is english and the first day of the week is Sunday (index 1). If the value of day is 1, the return value will be Sun. If the value of day is 2, the return value will be Mon, etc.

Parameters:

day - the index of the day of the week

Returns:

string that represent the short name of the day with the specified index in accordance with the locale

getLastDateInMonth

public static long getLastDateInMonth(long displayDate)

getLastDateInWeek

public static long getLastDateInWeek(long date)

getLastDateInYear

public static long getLastDateInYear(long date)

getLastMonthInYear

public static long getLastMonthInYear(long displayDate)