Cocoa中对日期和时间的处理 NSCalendar (一)

NSCalendar用于处理时间相关问题。比如比较时间前后、计算日期所的周别等。

1. 创建或初始化可用以下方法

    + (id)currentCalendar;

    取得当前用户的逻辑日历(logical calendar)

 

    + (id)autoupdatingCurrentCalendar;

    取得当前用户的逻辑日历(logical calendar), ......

 

    - (id)initWithCalendarIdentifier:(NSString *)identifier;

    初始化为各种日历。identifier的范围可以是:

       NSGregorianCalendar

       NSBuddhistCalendar

       NSChineseCalendar

       NSHebrewCalendar

       NSIslamicCalendar

       NSIslamicCivilCalendar

       NSJapaneseCalendar

2. 使用前若有必要可以先做以下设定

    - (void)setLocale:(NSLocale *)locale;

    设置区域

 

    - (void)setTimeZone:(NSTimeZone *)tz;

    设置时区

 

    - (void)setFirstWeekday:(NSUInteger)value;

    设定每周的第一天从星期几开始,比如:

    .  如需设定从星期日开始,则value传入1

    .  如需设定从星期一开始,则value传入2

    .  以此类推

    详细信息请参阅FirstWeekday属性

 

    - (void)setMinimumDaysInFirstWeek:(NSUInteger)value;

    设定作为(每年及每月)第一周必须包含的最少天数,比如:

    .  如需设定第一周最少包括7天,则value传入7

    详细信息请参阅MinimumDaysInFirstWeek属性

3. 取回设定信息用以下方法

    - (NSString *)calendarIdentifier

    返回日历标示符(identifier)。有效的日历标示符包括:

       NSGregorianCalendar

       NSBuddhistCalendar

       NSChineseCalendar

       NSHebrewCalendar

       NSIslamicCalendar

       NSIslamicCivilCalendar

       NSJapaneseCalendar

  

    - (NSLocale *)locale;

    返回日历指定的地区信息。它将影响???

 

    - (NSTimeZone *)timeZone;

    返回日历指定的时区信息。它将影响???

 

    - (NSUInteger)firstWeekday;

    返回日历指定的每周的第一天从星期几开始。缺省为星期天,即firstWeekday = 1

    当方法[NSCalendar ordinalityOfUnit: inUnit: fromDate:]的ordinalityOfUnit参数为NSWeekdayCalendarUnit,inUnit参数为NSWeekCalendarUnit时,firstWeekday属性影响它的返回值。具体说明如下:

    .  当firstWeekday被指定为星期天(即 = 1)时,它返回的值与星期几对应的数值保持一致。比如:

       fromDate传入的参数是星期日,则函数返回1

       fromDate传入的参数是星期一,则函数返回2

    .  当firstWeekday被指定为其它值时(即 <> 1)时,假设firstWeekday被指定为星期一(即 = 2),那么:

       fromDate传入的参数是星期一,则函数返回1

       fromDate传入的参数是星期二,则函数返回2

       fromDate传入的参数是星期日,则函数返回7

    - (NSUInteger)minimumDaysInFirstWeek;

    返回日历指定的第一周必须包含的最少天数。缺省为1,即minimumDaysInFirstWeek = 1。

    当方法[NSCalendar ordinalityOfUnit: inUnit: fromDate:]的ordinalityOfUnit参数为NSWeekCalendarUnit,inUnit参数为NSYearCalendarUnit时,minimumDaysInFirstWeek属性影响它的返回值。具体说明如下:

 

       2005年1月

       日   一   二   三   四   五   六

       --------------------------------

                                      1

        2    3    4    5    6    7    8   

        9   10   11   12   13   14   15  

       16   17   18   19   20   21   22

       23   24   25   26   27   28   29

       30   31  

 

    2005年1月第一周包括1号。

    a. 如果将minimumDaysInFirstWeek设定 = 1

       则fromDate传入1月1号,方法均返回1  ==> 满足minimumDaysInFirstWeek指定的天数(最少1天),所以方法将其归为2005年的第1周

       则fromDate传入1月2-8号,方法均返回2

       则fromDate传入1月9-15号,方法均返回3

       ......

 

    b. 如果将minimumDaysInFirstWeek设定为 > 1,比如2

       则fromDate传入1月1号,方法均返回53  ==> 不足2天,所以方法将其归为2004年的第53周

       则fromDate传入1月2-8号,方法均返回1

       则fromDate传入1月9-15号,方法均返回2

       ......

 

 

       2008年1月

       日   一   二   三   四   五   六

       ---------------------------------

                  1    2    3    4    5

        6    7    8    9   10   11   12

       13   14   15   16   17   18   19

       20   21   22   23   24   25   26

       27   28   29   30   31  

 

    2005年1月第一周包括1-5号共5天。

    a. 如果将minimumDaysInFirstWeek设定为 <= 5时

       则fromDate传入1月1-5号,方法均返回1  ==> 满足minimumDaysInFirstWeek指定的天数,所以方法将其归为2008年的第1周

       则fromDate传入1月6-12号,方法均返回2

       则fromDate传入1月13-19号,方法均返回3

       ......

    b. 如果将minimumDaysInFirstWeek设定为 > 5,比如6

       则fromDate传入1月1-5号,方法均返回53  ==> 当周不足6天,所以方法将其归为2007年的第53周

       则fromDate传入1月2-8号,方法均返回1

       则fromDate传入1月9-15号,方法均返回2

       ......

    当方法[NSCalendar ordinalityOfUnit: inUnit: fromDate:]的ordinalityOfUnit参数为NSWeekCalendarUnit,inUnit参数为NSMonthCalendarUnit时,minimumDaysInFirstWeek属性影响它的返回值。以2008年4月为例, 具体说明如下:

 

       2008年4月

       日   一   二   三   四   五   六

       ---------------------------------

                  1    2    3    4    5

        6    7    8    9   10   11   12

       13   14   15   16   17   18   19

       20   21   22   23   24   25   26

       27   28   29   30  

 

 

    2008年4月第一周包括1、2、3、4、5号。

    1. 如果将minimumDaysInFirstWeek设定为小于或等于5的数

       则fromDate传入4月1-5号,方法均返回1

       则fromDate传入4月6-12号,方法均返回2

       则fromDate传入4月13-19号,方法均返回3

       ....

    2. 如果将minimumDaysInFirstWeek设定为大于5的数

       则fromDate传入1-5号,方法均返回0

       则fromDate传入6-12号,方法均返回1

       则fromDate传入13-19号,方法均返回2

       ....

原文地址:https://www.cnblogs.com/zhaoguowen/p/4240070.html