DateDoodads (ATG Java API)

java.lang.Object
- atg.core.util.DateDoodads

Direct Known Subclasses:

GiftlistDateUtil
```
public class DateDoodads
extends java.lang.Object
```
Extra stuff for dealing with dates

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CLASS_VERSION` Class version string
`static char`	`DASH_CHAR`
`static java.lang.String`	`DASH_FORMATTER_STRING`
`static long`	`DAY_MILLIS`
`static java.util.TimeZone`	`GMT_TIMEZONE`
`static long`	`HOUR_MILLIS`
`static java.lang.String[]`	`kDays`
`static java.lang.String[]`	`kDaysAbbrev`
`static int[]`	`kLastDates`
`static java.lang.String[]`	`kMonthNumbers`
`static java.lang.String[]`	`kMonths`
`static java.lang.String[]`	`kMonthsAbbrev`
`static java.lang.String[]`	`kMonthsAbbrevLower`
`static java.lang.String[]`	`kMonthsLower`
`static long`	`MINUTE_MILLIS`
`static long`	`SECOND_MILLIS`
`static java.lang.String`	`SPACE_FORMATTER_STRING`
`static java.lang.String`	`TIMEZONE_STRING`
`static long`	`WEEK_MILLIS`
`static long`	`YEAR_MILLIS`

Constructor Summary

Constructors
Constructor and Description

DateDoodads()

Constructors
Constructor and Description
`DateDoodads()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static java.lang.String`	`approxIntervalString(java.util.Date startDate, java.util.Date endDate)` Formats the interval between two dates as a text string expressing the length of time, approximately.
`java.util.Date`	`dateFromDay(int iDays, int iYear)` Returns a date that is iDays into iYear.
`static java.lang.String`	`dateString(java.util.Date date)` This formats the date the way we want it - m/d/y It adds one to the month to correct Date's month range of 0-11
`static java.lang.String`	`dateStringFourDigitYear(java.util.Date date)` This formats the date the way we want it - m/d/y It adds one to the month to correct Date's month range of 0-11 This method prints a four digit year.
`static java.lang.String`	`dateTimeString(java.util.Date pDate)` Formats a date in a fashion that can be reconverted by stringDate()
`static java.lang.String`	`dayString(int iDay)` Returns the full day (English)
`static java.lang.String`	`dayStringAbbrev(int iDay)` Returns the 3 letter abbreviated day (English)
`static java.lang.String`	`httpDateString(long pTime)` These are the new httpDateString routines that work much better in March
`static java.lang.String`	`httpDateString(long pTime, char pDateSep)`
`static java.lang.String`	`httpDateStringOld(long pTime)` These are the old routines, they don't work very well in March Note: these routines are no longer used, but I kept them here just in case someone needed them.
`static java.lang.String`	`httpDateStringOld(long pTime, char pDateSep)`
`static java.lang.String`	`internetTimeString(java.util.Date pDate)` Formats a date as in RFC 850, 1036 & 822 Note that the year only has 2 digits!!!! So I guess the internet will be over at midnight
`static boolean`	`isLeapYear(int iYear)` Returns true if year is a leap year, according to the Gregorian Calendar.
`static int`	`lastDate(int iMonth, int iYear)` Returns the last date of a given month (accounting for leap year)
`static void`	`main(java.lang.String[] args)`
`static java.lang.String`	`monthString(int iMonth)` Returns the full month (English)
`static java.lang.String`	`monthStringAbbrev(int iMonth)` Returns the 3 letter appreviated month (English)
`static java.lang.String`	`padString(java.lang.String pThing, int pWidth, char pPad)`
`static boolean`	`sameDay(java.util.Date pDate1, java.util.Date pDate2)` Returns true if two dates match, ignoring time of day.
`static boolean`	`sameWeek(java.util.Date pDate1, java.util.Date pDate2)` Returns true if two dates occur during the same calendar week (i.e.
`static void`	`setThrowTwoDigitYearException(boolean pThrowException)` Call this method with a flag to turn off the throwing of the 2 digit year exception.
`static void`	`setTwoDigitWrapYear(int pYear)` Call this method to set the year from which we wrap two digit years.
`static java.util.Date`	`stringDate(java.lang.String iDate)` This converts a string to a date.
`static java.lang.String`	`timeString(java.util.Date iDate)` Formats the time of a date in 12-hour format, as HH:MM[am/pm]

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CLASS_VERSION
```
public static java.lang.String CLASS_VERSION
```
    Class version string
  - kMonths
```
public static final java.lang.String[] kMonths
```
  - kMonthsLower
```
public static final java.lang.String[] kMonthsLower
```
  - kMonthsAbbrev
```
public static final java.lang.String[] kMonthsAbbrev
```
  - kMonthsAbbrevLower
```
public static final java.lang.String[] kMonthsAbbrevLower
```
  - kMonthNumbers
```
public static final java.lang.String[] kMonthNumbers
```
  - kLastDates
```
public static final int[] kLastDates
```
  - kDays
```
public static final java.lang.String[] kDays
```
  - kDaysAbbrev
```
public static final java.lang.String[] kDaysAbbrev
```
  - SECOND_MILLIS
```
public static final long SECOND_MILLIS
```
    See Also:
    
    Constant Field Values
  - MINUTE_MILLIS
```
public static final long MINUTE_MILLIS
```
    See Also:
    
    Constant Field Values
  - HOUR_MILLIS
```
public static final long HOUR_MILLIS
```
    See Also:
    
    Constant Field Values
  - DAY_MILLIS
```
public static final long DAY_MILLIS
```
    See Also:
    
    Constant Field Values
  - WEEK_MILLIS
```
public static final long WEEK_MILLIS
```
    See Also:
    
    Constant Field Values
  - YEAR_MILLIS
```
public static final long YEAR_MILLIS
```
    See Also:
    
    Constant Field Values
  - SPACE_FORMATTER_STRING
```
public static final java.lang.String SPACE_FORMATTER_STRING
```
    See Also:
    
    Constant Field Values
  - DASH_FORMATTER_STRING
```
public static final java.lang.String DASH_FORMATTER_STRING
```
    See Also:
    
    Constant Field Values
  - DASH_CHAR
```
public static final char DASH_CHAR
```
    See Also:
    
    Constant Field Values
  - TIMEZONE_STRING
```
public static final java.lang.String TIMEZONE_STRING
```
    See Also:
    
    Constant Field Values
  - GMT_TIMEZONE
```
public static final java.util.TimeZone GMT_TIMEZONE
```
- Constructor Detail
  - DateDoodads
```
public DateDoodads()
```
- Method Detail
  - lastDate
```
public static int lastDate(int iMonth,
                           int iYear)
```
    Returns the last date of a given month (accounting for leap year)
    
    Parameters:
    
    iMonth - Month (0 - 11) as in java.util.Date
    
    iYear - Year after 1900 as in java.util.Date
    
    See Also:
    
    Date
  - isLeapYear
```
public static boolean isLeapYear(int iYear)
```
    Returns true if year is a leap year, according to the Gregorian Calendar.
    
    Parameters:
    
    iYear - Year after 1900 as in java.util.Date
    
    See Also:
    
    Date
  - monthString
```
public static java.lang.String monthString(int iMonth)
```
    Returns the full month (English)
    
    Parameters:
    
    iMonth - Month 0-11 as in java.util.Date
    
    See Also:
    
    Date
  - monthStringAbbrev
```
public static java.lang.String monthStringAbbrev(int iMonth)
```
    Returns the 3 letter appreviated month (English)
    
    Parameters:
    
    iMonth - Month 0-11 as in java.util.Date
    
    See Also:
    
    Date
  - dayString
```
public static java.lang.String dayString(int iDay)
```
    Returns the full day (English)
    
    Parameters:
    
    iDay - Day 0-6 as in java.util.Date
    
    See Also:
    
    Date
  - dayStringAbbrev
```
public static java.lang.String dayStringAbbrev(int iDay)
```
    Returns the 3 letter abbreviated day (English)
    
    Parameters:
    
    iDay - Day 0-6 as in java.util.Date
    
    See Also:
    
    Date
  - dateString
```
public static java.lang.String dateString(java.util.Date date)
```
    This formats the date the way we want it - m/d/y It adds one to the month to correct Date's month range of 0-11
  - dateStringFourDigitYear
```
public static java.lang.String dateStringFourDigitYear(java.util.Date date)
```
    This formats the date the way we want it - m/d/y It adds one to the month to correct Date's month range of 0-11 This method prints a four digit year. This is done by adding 1900 to the year returned by Date.
  - timeString
```
public static java.lang.String timeString(java.util.Date iDate)
```
    Formats the time of a date in 12-hour format, as HH:MM[am/pm]
  - approxIntervalString
```
public static java.lang.String approxIntervalString(java.util.Date startDate,
                                                    java.util.Date endDate)
```
    Formats the interval between two dates as a text string expressing the length of time, approximately.
  - stringDate
```
public static java.util.Date stringDate(java.lang.String iDate)
                                 throws java.lang.IllegalArgumentException
```
    This converts a string to a date. If the string is m/d/y input, it corrects the month.
    WARNING : Two digit years are no longer supported by defualt. We strongly recommend that you do not use 2 digit years. If you do pass in a 2 digit year then a TwoDigitYearException will be thrown, containing the date calculated by the following heuristic:
    Two digit dates before 1970 in m/d/y will be translated to 20xx!!!!!!
    We also look for the year. If the year is less than 70, we assume that it is for the next century as in 2005. We add 100 to correct the year in Date since it is measured from 1900.
    
    Throws:
    
    java.lang.IllegalArgumentException
  - setThrowTwoDigitYearException
```
public static void setThrowTwoDigitYearException(boolean pThrowException)
```
    Call this method with a flag to turn off the throwing of the 2 digit year exception.
  - setTwoDigitWrapYear
```
public static void setTwoDigitWrapYear(int pYear)
```
    Call this method to set the year from which we wrap two digit years.
  - internetTimeString
```
public static java.lang.String internetTimeString(java.util.Date pDate)
```
    Formats a date as in RFC 850, 1036 & 822
    Note that the year only has 2 digits!!!! So I guess the internet will be over at midnight
    
    Parameters:
    
    pDate - a java.util.Date
    
    See Also:
    
    Date
  - dateTimeString
```
public static java.lang.String dateTimeString(java.util.Date pDate)
```
    Formats a date in a fashion that can be reconverted by stringDate()
  - httpDateString
```
public static java.lang.String httpDateString(long pTime)
```
    These are the new httpDateString routines that work much better in March
  - httpDateString
```
public static java.lang.String httpDateString(long pTime,
                                              char pDateSep)
```
  - httpDateStringOld
```
public static java.lang.String httpDateStringOld(long pTime)
```
    These are the old routines, they don't work very well in March Note: these routines are no longer used, but I kept them here just in case someone needed them. See Bug# 70307
  - httpDateStringOld
```
public static java.lang.String httpDateStringOld(long pTime,
                                                 char pDateSep)
```
  - sameDay
```
public static boolean sameDay(java.util.Date pDate1,
                              java.util.Date pDate2)
```
    Returns true if two dates match, ignoring time of day.
  - sameWeek
```
public static boolean sameWeek(java.util.Date pDate1,
                               java.util.Date pDate2)
```
    Returns true if two dates occur during the same calendar week (i.e. the same Sun-to-Mon interval)
  - dateFromDay
```
public java.util.Date dateFromDay(int iDays,
                                  int iYear)
```
    Returns a date that is iDays into iYear. Specify a base year and any number of days, and get back a Date that many days away from Jan. 1 of the base year. Use to work around java.util.Data bug that produces wrong dates if the specified number of days is >=128 in any Date(int, int, int [...]) constructor.
    
    Parameters:
    
    iDays - Days (0 - 731)
    
    iYear - Year after 1900 as in java.util.Date
  - padString
```
public static java.lang.String padString(java.lang.String pThing,
                                         int pWidth,
                                         char pPad)
```
  - main
```
public static void main(java.lang.String[] args)
```

Class DateDoodads

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CLASS_VERSION

kMonths

kMonthsLower

kMonthsAbbrev

kMonthsAbbrevLower

kMonthNumbers

kLastDates

kDays

kDaysAbbrev

SECOND_MILLIS

MINUTE_MILLIS

HOUR_MILLIS

DAY_MILLIS

WEEK_MILLIS

YEAR_MILLIS

SPACE_FORMATTER_STRING

DASH_FORMATTER_STRING

DASH_CHAR

TIMEZONE_STRING

GMT_TIMEZONE

Constructor Detail

DateDoodads

Method Detail

lastDate

isLeapYear

monthString

monthStringAbbrev

dayString

dayStringAbbrev

dateString

dateStringFourDigitYear

timeString

approxIntervalString

stringDate

setThrowTwoDigitYearException

setTwoDigitWrapYear

internetTimeString

dateTimeString

httpDateString

httpDateString

httpDateStringOld

httpDateStringOld

sameDay

sameWeek

dateFromDay

padString

main