JavaTM 2 Platform
Standard Ed. 5.0

类 java.util.Calendar
的使用

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

java.sqlCalendar 的使用
 

参数类型为 Calendarjava.sql 中的方法
 Date ResultSet.getDate(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Date CallableStatement.getDate(int parameterIndex, Calendar cal)
          以 java.sql.Date 对象的形式检索指定 JDBC DATE 参数的值,使用给定 Calendar 对象构造日期。
 Date ResultSet.getDate(String columnName, Calendar cal)
          以 Java 编程语言中 java.sql.Date 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Date CallableStatement.getDate(String parameterName, Calendar cal)
          以 java.sql.Date 对象的形式检索 JDBC DATE 参数的值,使用给定 Calendar 对象构造日期。
 Time ResultSet.getTime(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Time CallableStatement.getTime(int parameterIndex, Calendar cal)
          以 java.sql.Time 对象的形式检索指定 JDBC TIME 参数的值,使用给定 Calendar 对象构造时间。
 Time ResultSet.getTime(String columnName, Calendar cal)
          以 Java 编程语言中 java.sql.Time 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Time CallableStatement.getTime(String parameterName, Calendar cal)
          以 java.sql.Time 对象的形式检索 JDBC TIME 参数的值,使用给定 Calendar 对象构造时间。
 Timestamp ResultSet.getTimestamp(int columnIndex, Calendar cal)
          以 Java 编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Timestamp CallableStatement.getTimestamp(int parameterIndex, Calendar cal)
          java.sql.Timestamp 对象的形式检索指定 JDBC TIMESTAMP 参数的值,使用给定 Calendar 对象构造 Timestamp 对象。
 Timestamp ResultSet.getTimestamp(String columnName, Calendar cal)
          以 Java 编程语言中 java.sql.Timestamp 对象的形式检索此 ResultSet 对象的当前行中指定列的值。
 Timestamp CallableStatement.getTimestamp(String parameterName, Calendar cal)
          以 java.sql.Timestamp 对象的形式检索 JDBC TIMESTAMP 参数的值,使用给定 Calendar 对象构造 Timestamp 对象。
 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()
          获得与此日期/时间 formatter 关联的日历。
 

参数类型为 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.setTime(int parameterIndex, Time x, Calendar cal)
          使用给定的 java.sql.Time 值设置此 RowSet 对象命令中的指定参数。
 void RowSet.setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
          使用给定的 java.sql.Timestamp 值设置此 RowSet 对象命令中的指定参数。
 

javax.sql.rowsetCalendar 的使用
 

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

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 2 Platform
Standard Ed. 5.0

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

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