JavaTM Platform
Standard Ed. 6

类 java.util.Calendar
的使用

使用 Calendar 的软件包
java.sql 提供使用 JavaTM 编程语言访问并处理存储在数据源(通常是一个关系数据库)中的数据的 API。 
java.text 提供以与自然语言无关的方式来处理文本、日期、数字和消息的类和接口。 
java.util 包含 collection 框架、遗留的 collection 类、事件模型、日期和时间设施、国际化和各种实用工具类(字符串标记生成器、随机数生成器和位数组)。 
javax.sql 为通过 JavaTM 编程语言进行服务器端数据源访问和处理提供 API。 
javax.sql.rowset JDBC RowSet 实现的标准接口和基类。 
javax.xml.bind 为包含解组、编组和验证功能的客户端应用程序提供运行时绑定框架。 
javax.xml.datatype XML/Java 类型映射关系。 
 

java.sqlCalendar 的使用
 

参数类型为 Calendarjava.sql 中的方法
 Date CallableStatement.getDate(int parameterIndex, Calendar cal)
          以 java.sql.Date 对象的形式获取指定 JDBC DATE 参数的值,使用给定 Calendar 对象构造日期。
 Date ResultSet.getDate(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Date CallableStatement.getDate(String parameterName, Calendar cal)
          以 java.sql.Date 对象的形式获取 JDBC DATE 参数的值,使用给定 Calendar 对象构造日期。
 Date ResultSet.getDate(String columnLabel, Calendar cal)
          以 Java 编程语言中 java.sql.Date 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Time CallableStatement.getTime(int parameterIndex, Calendar cal)
          以 java.sql.Time 对象的形式获取指定 JDBC TIME 参数的值,使用给定 Calendar 对象构造时间。
 Time ResultSet.getTime(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Time CallableStatement.getTime(String parameterName, Calendar cal)
          以 java.sql.Time 对象的形式获取 JDBC TIME 参数的值,使用给定 Calendar 对象构造时间。
 Time ResultSet.getTime(String columnLabel, Calendar cal)
          以 Java 编程语言中 java.sql.Time 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Timestamp CallableStatement.getTimestamp(int parameterIndex, Calendar cal)
          以 java.sql.Timestamp 对象的形式获取指定 JDBC TIMESTAMP 参数的值,使用给定 Calendar 对象构造 Timestamp 对象。
 Timestamp ResultSet.getTimestamp(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 Timestamp CallableStatement.getTimestamp(String parameterName, Calendar cal)
          以 java.sql.Timestamp 对象的形式获取 JDBC TIMESTAMP 参数的值,使用给定 Calendar 对象构造 Timestamp 对象。
 Timestamp ResultSet.getTimestamp(String columnLabel, Calendar cal)
          以 Java 编程语言中 java.sql.Timestamp 对象的形式获取此 ResultSet 对象的当前行中指定列的值。
 void PreparedStatement.setDate(int parameterIndex, Date x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Date 值。
 void CallableStatement.setDate(String parameterName, Date x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Date 值。
 void PreparedStatement.setTime(int parameterIndex, Time x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Time 值。
 void CallableStatement.setTime(String parameterName, Time x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Time 值。
 void PreparedStatement.setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Timestamp 值。
 void CallableStatement.setTimestamp(String parameterName, Timestamp x, Calendar cal)
          使用给定的 Calendar 对象将指定参数设置为给定 java.sql.Timestamp 值。
 

java.textCalendar 的使用
 

声明为 Calendarjava.text 中的字段
protected  Calendar DateFormat.calendar
          DateFormat 使用 calendar 来生成实现日期和时间格式化所需的时间字段值。
 

返回 Calendarjava.text 中的方法
 Calendar DateFormat.getCalendar()
          获取与此日期/时间格式器关联的日历。
 

参数类型为 Calendarjava.text 中的方法
 void DateFormat.setCalendar(Calendar newCalendar)
          设置此日期格式所使用的日历。
 

java.utilCalendar 的使用
 

java.utilCalendar 的子类
 class GregorianCalendar
          GregorianCalendarCalendar 的一个具体子类,提供了世界上大多数国家/地区使用的标准日历系统。
 

返回 Calendarjava.util 中的方法
static Calendar Calendar.getInstance()
          使用默认时区和语言环境获得一个日历。
static Calendar Calendar.getInstance(Locale aLocale)
          使用默认时区和指定语言环境获得一个日历。
static Calendar Calendar.getInstance(TimeZone zone)
          使用指定时区和默认语言环境获得一个日历。
static Calendar Calendar.getInstance(TimeZone zone, Locale aLocale)
          使用指定时区和语言环境获得一个日历。
 

参数类型为 Calendarjava.util 中的方法
 int Calendar.compareTo(Calendar anotherCalendar)
          比较两个 Calendar 对象表示的时间值(从历元至现在的毫秒偏移量)。
 

javax.sqlCalendar 的使用
 

参数类型为 Calendarjavax.sql 中的方法
 void RowSet.setDate(int parameterIndex, Date x, Calendar cal)
          使用给定 java.sql.Date 值设置此 RowSet 对象命令中的指定参数。
 void RowSet.setDate(String parameterName, Date x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Date 值。
 void RowSet.setTime(int parameterIndex, Time x, Calendar cal)
          使用给定 java.sql.Time 值设置此 RowSet 对象命令中的指定参数。
 void RowSet.setTime(String parameterName, Time x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Time 值。
 void RowSet.setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
          使用给定 java.sql.Timestamp 值设置此 RowSet 对象命令中的指定参数。
 void RowSet.setTimestamp(String parameterName, Timestamp x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Timestamp 值。
 

javax.sql.rowsetCalendar 的使用
 

参数类型为 Calendarjavax.sql.rowset 中的方法
 void BaseRowSet.setDate(int parameterIndex, Date x, Calendar cal)
          将指定参数设置为给定的 java.sql.Date 对象。
 void BaseRowSet.setDate(String parameterName, Date x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Date 值。
 void BaseRowSet.setTime(int parameterIndex, Time x, Calendar cal)
          将指定参数设置为给定的 java.sql.Time 对象。
 void BaseRowSet.setTime(String parameterName, Time x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Time 值。
 void BaseRowSet.setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
          将指定参数设置为给定的 java.sql.Timestamp 对象。
 void BaseRowSet.setTimestamp(String parameterName, Timestamp x, Calendar cal)
          使用给定 Calendar 对象将指定参数设置为给定的 java.sql.Timestamp 值。
 

javax.xml.bindCalendar 的使用
 

返回 Calendarjavax.xml.bind 中的方法
static Calendar DatatypeConverter.parseDate(String lexicalXSDDate)
           将字符串参数转换为一个 Calendar 值。
 Calendar DatatypeConverterInterface.parseDate(String lexicalXSDDate)
           将字符串参数转换为一个 Calendar 值。
static Calendar DatatypeConverter.parseDateTime(String lexicalXSDDateTime)
           将字符串参数转换为一个 Calendar 值。
 Calendar DatatypeConverterInterface.parseDateTime(String lexicalXSDDateTime)
           将字符串参数转换为一个 Calendar 值。
static Calendar DatatypeConverter.parseTime(String lexicalXSDTime)
           将字符串参数转换为一个 Calendar 值。
 Calendar DatatypeConverterInterface.parseTime(String lexicalXSDTime)
           将字符串参数转换为一个 Calendar 值。
 

参数类型为 Calendarjavax.xml.bind 中的方法
static String DatatypeConverter.printDate(Calendar val)
           将 Calendar 值转换为一个字符串。
 String DatatypeConverterInterface.printDate(Calendar val)
           将 Calendar 值转换为一个字符串。
static String DatatypeConverter.printDateTime(Calendar val)
           将 Calendar 值转换为一个字符串。
 String DatatypeConverterInterface.printDateTime(Calendar val)
           将 Calendar 值转换为一个字符串。
static String DatatypeConverter.printTime(Calendar val)
           将 Calendar 值转换为一个字符串。
 String DatatypeConverterInterface.printTime(Calendar val)
           将 Calendar 值转换为一个字符串。
 

javax.xml.datatypeCalendar 的使用
 

参数类型为 Calendarjavax.xml.datatype 中的方法
abstract  void Duration.addTo(Calendar calendar)
          将此持续时间添加到 Calendar 对象。
 long Duration.getTimeInMillis(Calendar startInstant)
          返回以毫秒为单位的持续时间的长度。
abstract  Duration Duration.normalizeWith(Calendar startTimeInstant)
          通过使用特定的时间点作为参考点,将 years 和 months 字段转换为 days 字段。
 


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策