jcx.util
Class datetime

java.lang.Object
  |
  +--jcx.util.datetime

public class datetime

extends java.lang.Object

  得到日期,時間,也可以得到幾天前的時間(or幾天後)
  程式設計師:kydan 

Constructor Summary

datetime()

Method Summary

static java.lang.String	dateAdd(java.lang.String unit, int amount) 使用說明: 以今天為基準,向後增加一段時間,亦可向前,amount只要是負的就是向前推算, 但若以日期,週為單位來做向前推算的動作,則只能計算這個月內的, 回傳字串格式, ex:想要得到 3天前的日期,2週後的日期等等.
static java.lang.String	dateAdd(java.lang.String day, java.lang.String unit, int amount) 使用說明: 以傳入的時間為基準,向後增加一段時間,亦可向前,amount只要是負的就是向前推算, 但若以日期,週為單位來做向前推算的動作,則只能計算同一個月內的, 回傳是字串型態,民國年,西元年均可使用 ex:想要得到 3天前的日期,2週後的日期等等.
static int	getDate(int day) 使用說明: 得到傳入日期(年月日)的日,int 格式 程式設計師:kydan .
static java.lang.String	getDate(java.lang.String day) 使用說明: 得到傳入日期(年月日)的日,String 格式 程式設計師:kydan .
static int	getDayOfWeek(java.lang.String day) 使用說明: 得到傳入日期是星期幾,星期天 return 0, 星期一 return 1 .
static int	getMonth(int day) 使用說明: 得到傳入日期的月份,int 格式 程式設計師:kydan .
static java.lang.String	getMonth(java.lang.String day) 使用說明: 得到傳入日期的月份,String 格式 程式設計師:kydan .
static java.lang.String	getTime(java.lang.String str) 使用說明: 得到目前的時間.
static int	getToday() 使用說明: 得到今天的日期 程式設計師:kydan .
static java.lang.String	getToday(java.lang.String str) 使用說明: 得到今天的日期.
static java.lang.String	getToday1() 使用說明: 得到今天的日期(西元年YYYY/mm/dd) 程式設計師:kydan .
static int	getYear(int day) 使用說明: 得到傳入日期的年份,int 格式 程式設計師:kydan .
static java.lang.String	getYear(java.lang.String day) 使用說明: 得到傳入日期的年份,String 格式 程式設計師:kydan .
static void	main(java.lang.String[] arg)
static int	subDays1(java.lang.String date1, java.lang.String date2) 使用說明: 計算兩日期間相差天數(date1-date2) (西元 或 民國年) 程式設計師:chris.

Methods inherited from class java.lang.Object

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

Constructor Detail

datetime

public datetime()

Method Detail

getToday

public static int getToday()

  使用說明:
    得到今天的日期
  程式設計師:kydan 

.

  Parameters: 
    無 
  Returns: 
    return 今天的日期 , 格式:870807 (年月日) (民國年)
  Throws:
    無 
 Example:
   int today=datetime.getToday();

getToday1

public static java.lang.String getToday1()

  使用說明:
    得到今天的日期(西元年YYYY/mm/dd)
  程式設計師:kydan 

.

  Parameters: 
    無 
  Returns: 
    return 今天的日期(ex:2000/1/5)
  Throws:
    無 
 Example:
   String today=datetime.getToday1();

getYear

public static int getYear(int day)

  使用說明:
    得到傳入日期的年份,int 格式
  程式設計師:kydan 

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期的年份 
  Throws:
   if error ,則 return 0
 Example:
   int day=870909;
   int year=datetime.getYear(day);

getYear

public static java.lang.String getYear(java.lang.String day)

  使用說明:
    得到傳入日期的年份,String 格式
  程式設計師:kydan 

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期的年份 
  Throws:
   if error ,則 return "0"
 Example:
   String day="870909";
   String year=datetime.getYear(day);

getMonth

public static int getMonth(int day)

  使用說明:
    得到傳入日期的月份,int 格式
  程式設計師:kydan 

. Parameters: day - 傳入的日期,格式 870909 or 1030909 or 19980909 Returns: return 傳入日期的月份 Throws: if error ,則 return 0 Example: int day=870909; int mouth=datetime.getMouth(day);

getMonth

public static java.lang.String getMonth(java.lang.String day)

  使用說明:
    得到傳入日期的月份,String 格式
  程式設計師:kydan 

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期的月份 
  Throws:
   if error ,則 return "0"
 Example:
   String day="870909";
   String mouth=datetime.getMonth(day);

getDayOfWeek

public static int getDayOfWeek(java.lang.String day)

  使用說明:
    得到傳入日期是星期幾,星期天 return 0, 星期一 return 1
  

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期是星期幾,星期天 return 0, 星期一 return 1
  Throws:
   if error ,則 return 0
 Example:
   String day="870909";
   int day=datetime.getDayOfWeek(day);

getDate

public static int getDate(int day)

  使用說明:
    得到傳入日期(年月日)的日,int 格式
  程式設計師:kydan 

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期(年月日)的日
  Throws:
   if error ,則 return 0,
 Example:
   int day=870909;
   int date=datetime.getDate(day);

getDate

public static java.lang.String getDate(java.lang.String day)

  使用說明:
    得到傳入日期(年月日)的日,String 格式
  程式設計師:kydan 

.

  Parameters: 
    day - 傳入的日期,格式 870909 or 1030909 or 19980909
  Returns: 
    return 傳入日期(年月日)的日
  Throws:
   if error ,則 return "0",
 Example:
   String day="870909";
   String date=datetime.getDate(day);

getToday

public static java.lang.String getToday(java.lang.String str)

  使用說明:
    得到今天的日期

.

 Parameters: (String str) 
   str - 所想要的格式 like:"yy/mm/dd","YYYY/mm/dd"......,

 Returns: 
   if (str.equals("yymmdd"))   return 年月日 (民國年)   ,格式:870807
   if (str.equals("mmddyy"))   return 月日年 (民國年)   ,格式:080787
   if (str.equals("yy/mm/dd")) return 年/月/日 (民國年) ,格式:87/08/07
   if (str.equals("mm/dd/yy")) return 月/日/年 (民國年) ,格式:08/07/87
   if (str.equals("yy/mm"))    return 年/月    (民國年) ,格式:87/08
   if (str.equals("yymm"))     return 年月   (民國年)   ,格式:8708
   if (str.equals("mmdd"))     return 月日              ,格式:0807 
   if (str.equals("YYYY/mm/dd")) return 年/月/日 (西元年) ,格式:1998/08/07
   if (str.equals("mm/dd/YYYY")) return 月/日/年 (西元年) ,格式:08/07/1998
   if (str.equals("YYYYmmdd")) return 年月日 (西元年)     ,格式:19980807
   if (str.equals("mmddYYYY")) return 月日年 (西元年)     ,格式:08071998
   if (str.equals("YY/mm/dd")) return 年/月/日 (西元年)   ,格式:98/08/07
   if (str.equals("mm/dd/YY")) return 月/日/年 (西元年)   ,格式:08/07/98
   if (str.equals("YY,mm,dd")) return 年,月,日 (西元年)   ,格式:98,08,07
   if (str.equals("mm,dd,YY")) return 月,日,年 (西元年)   ,格式:08,07,98
   if (str.equals("YYmmdd"))   return 年月日 (西元年)     ,格式:980807
   if (str.equals("mmddYY"))   return 月日年 (西元年)     ,格式:080798
   if (str.equals("YYmm"))   return 年月   (西元年)       ,格式:9808
   if (str.equals("YYYYmm"))   return 年月 (西元年)       ,格式:199808
   if (str.equals("YY/mm"))   return 年月   (西元年)      ,格式:98/08
   if (str.equals("YYYY/mm"))   return 年月 (西元年)      ,格式:1998/08

 Throws:
   如果傳入的參數沒有這個格式,則 return "0",
   故使用這個method時,可以利用這個error message來加以判別是否有異常.

 Example:
   String today=datetime.getToday("yy/mm/dd");
   System.out.println(today);
   output will be like 87/08/07

getTime

public static java.lang.String getTime(java.lang.String str)

 使用說明:
   得到目前的時間

.

 Parameters: (String str)
   str - 所想要的格式 like:"h:m:s","h點m分s秒"......,

 Returns: 
   if (str.equals("hms")) return 時分秒                           ,格式: 140717
   if (str.equals("h:m:s")) return 時:分:秒                       ,格式: 14:07:17
   if (str.equals("h點m分s秒")) return h點m分s秒                  ,格式: 14點07分17秒
   if (str.equals("pm/am h點m分s秒")) return AM(or PM) h點m分s秒  ,格式: PM 02點07分17秒
   if (str.equals("yy/mm/dd h:m:s")) return 年/月/日 時:分:秒   ,格式: 87/08/07 14:07:17 (民國年)
   if (str.equals("yymmdd hms"))     return 年/月/日 時:分:秒   ,格式: 870807 140717     (民國年)
   if (str.equals("YY/mm/dd h:m:s")) return 年/月/日 時:分:秒   ,格式: 98/08/07 14:07:17 (西元年)
   if (str.equals("YYYY/mm/dd h:m:s")) return 年/月/日 時:分:秒 ,格式: 1998/08/07 14:07:17 (西元年)
   if (str.equals("YYYYmmdd hms")) return 年月日 時分秒         ,格式: 19980807 140717 (西元年)
   if (str.equals("mm/dd/yy h:m:s")) return 月/日/年 時:分:秒   ,格式: 08/07/87 14:07:17 (民國年)
   if (str.equals("mm/dd/YY h:m:s")) return 月/日/年 時:分:秒   ,格式: 08/07/98 14:07:17 (西元年)
   if (str.equals("mm/dd/YYYY h:m:s")) return 月/日/年 時:分:秒 ,格式: 08/07/1998 14:07:17 (西元年)
	 
 Throws:
   如果傳入的參數沒有這個格式,則 return "0",
   故使用這個method時,可以利用這個error message來加以判別是否有異常 

 Example:
   String time=datetime.getTime("h:m:s");
   System.out.println(time);
   output will be like 14:07:17

dateAdd

public static java.lang.String dateAdd(java.lang.String unit,
                                       int amount)

 使用說明:
   以今天為基準,向後增加一段時間,亦可向前,amount只要是負的就是向前推算,
   但若以日期,週為單位來做向前推算的動作,則只能計算這個月內的, 
   回傳字串格式,
   ex:想要得到 3天前的日期,2週後的日期等等

.

 Parameters: 
   unit - 單位:y(民國年),m(月),d(日),w(週) 
   amonut - 數量,ex '-3'天,'2'週......,

 Returns: 
   if(unit==y)  return year+(or -)amount; // 如果 unit 等於 y,年加(or 減) amount 
   if(unit==m)  return month+(or -)amount; // 如果 unit 等於 m,月加(or 減) amount 
   if(unit==d)  return day+(or -)amount; // 如果 unit 等於 d,日加(or 減) amount 
   if(unit==w)  return week+(or -)amount; // 如果 unit 等於 w,週加(or 減) amount 

 Throws
   如果傳入的unit格式不對,則 return 0
   如果向前推算有誤,則 return 0 
   故使用這個method時,可以利用這個error message來加以判別是否有異常 

 Example:
   int day=datetime.dateAdd("d",-3);
   System.out.println(day);
   if today is 870807
   output will be like 870804

   int day=datetime.dateAdd("w",1);
   System.out.println(day);
   if today is 870807
   output will be like 870814

dateAdd

public static java.lang.String dateAdd(java.lang.String day,
                                       java.lang.String unit,
                                       int amount)

  使用說明:
    以傳入的時間為基準,向後增加一段時間,亦可向前,amount只要是負的就是向前推算,
    但若以日期,週為單位來做向前推算的動作,則只能計算同一個月內的,
    回傳是字串型態,民國年,西元年均可使用
    ex:想要得到 3天前的日期,2週後的日期等等

.

  Parameters: 
    day - 日期,格式:"870807"
    unit - 單位:y(年),m(月),d(日),w(週) 
    amount - 數量,ex '-3'天,'2'週......,

  Returns: 
    if(unit==y)  return year+(or -)amount; // 如果 unit 等於 y,年加(or 減) amount 
    if(unit==m)  return month+(or -)amount; // 如果 unit 等於 m,月加(or 減) amount 
    if(unit==d)  return day+(or -)amount; // 如果 unit 等於 d,日加(or 減) amount 
    if(unit==w)  return week+(or -)amount; // 如果 unit 等於 w,週加(or 減) amount 

  Throws
    如果傳入的unit格式不對,則 return 0
    如果傳入的date格式不對,則 return 0
    如果向前推算有誤,則 return 0 
    故使用這個method時,可以利用這個error message來加以判別是否有異常 

  example:
    String day=datetime.dateAdd("870807","d",-3);
    System.out.println(day);
    output will be like 870804
 
    String day=datetime.dateAdd("870807","w",1);
    Syetem.out.println(day);
    output will be like 870814
 

subDays1

public static int subDays1(java.lang.String date1,
                           java.lang.String date2)

 使用說明:
     計算兩日期間相差天數(date1-date2) (西元 或 民國年)
     程式設計師:chris

.

 Parameters: 
   day1 - 日期,格式:"19980507"
   day2 - 日期,格式:"19980807"
 Throw:
   if error , return 0

 example:
   int days=datetime.subDays1("19980901","19980909");  return 天數

main

public static void main(java.lang.String[] arg)