Altova XMLSpy 2023 Enterprise Edition

Altova.Types.DateTime

此类可用于处理具有日期和时间类型（例如xs:dateTime）的XML特性或元素。

构造函数

	Name	描述
	DateTime(DateTime obj)	将DateTime类的新实例初始化为作为参数提供的DateTime对象。
	DateTime(System.DateTime newvalue)	将DateTime类的新实例初始化为作为参数提供的System.DateTime对象。
	DateTime(int year, int month, int day, int hour, int minute, double second, int offsetTZ)	将DateTime类的新实例初始化为作为参数提供的年、月、日、小时、分钟、秒和时区偏移。
	DateTime(int year, int month, int day, int hour, int minute, double second)	将DateTime类的新实例初始化为作为参数提供的年、月、日、小时、分钟和秒。
	DateTime(int year, int month, int day)	将DateTime类的新实例初始化为作为参数提供的年、月和日。

属性

	Name	描述
	bool HasTimezone	获取一个布尔值，该值指示DateTime是否具有时区。
	static DateTime Now	获取一个DateTime对象，该对象被设为此计算机上的当前日期和时间。
	short TimezoneOffset	获取或设置DateTime对象的时区偏移（以分钟为单位）。
	System.DateTime Value	获取或设置DateTime对象的值作为System.DateTime值。

方法

	Name	描述
	int CompareTo(object obj)	DateTime类实现IComparable接口。此方法将DateTime的当前实例与另一个对象进行比较，并返回一个整数，指示当前实例在排序顺序中是在另一个对象之前、之后还是出现在同一位置。另请参见https://msdn.microsoft.com/en-us/library/system.icomparable.compareto(v=vs.110).aspx。
	override bool Equals(object obj)	如果指定的对象等于当前对象，则返回true；否则返回false
	System.DateTime GetDateTime(bool correctTZ)	从当前Altova.Types.DateTime实例返回一个System.DateTime对象。correctTZ布尔参数指定返回对象的时间是否必须根据当前Altova.Types.DateTime实例的时区进行调整。
	override int GetHashCode()	返回当前实例的哈希代码。
	int GetWeekOfMonth()	以整数形式返回一月中的某周。
	static DateTime Parse( string s )	从作为参数提供的字符串中创建一个DateTime对象。例如，以下示例字符串值将被成功转换为一个DateTime对象： 2015-01-01T23:23:23 2015-01-01 2015-11 23:23:23 如果该字符串无法转换为DateTime对象，则会引发异常。请注意，此方法是静态的，只能在Altova.Types.DateTime类本身上调用，而不能在该类的实例上调用。
	static DateTime Parse(string s, DateTimeFormat format)	使用作为参数提供的格式从字符串创建一个DateTime对象。有关格式列表，请参见Altova.Types.DateTimeFormat。如果该字符串无法转换为DateTime对象，则会引发异常。请注意，此方法是静态的，只能在Altova.Types.DateTime类本身上调用，而不能在该类的实例上调用。
	override string ToString()	将DateTime对象转换为字符串。
	string ToString(DateTimeFormat format)	使用作为参数提供的格式将DateTime对象转换为字符串。有关格式列表，请参见Altova.Types.DateTimeFormat。

运算符

Name	描述
!=	确定DateTime a是否不等于DateTime b。
<	确定DateTime a是否小于DateTime b。
<=	确定DateTime a是否小于或等于DateTime b。
==	确定DateTime a是否等于DateTime b。
>	确定DateTime a是否大于DateTime b。
>=	确定DateTime a是否大于或等于DateTime b。

示例

在您的程序中使用以下代码片段之前，请确保已导入Altova类型：

using Altova.Types;

以下代码片段展示了创建DateTime对象的各种方法：

protected static void DateTimeExample1()
{
// Create a DateTime object from the current system time
Altova.Types.DateTime dt = new Altova.Types.DateTime(System.DateTime.Now);
Console.WriteLine("The current time is: " + dt.ToString());

// Create an Altova DateTime object from parts (no timezone)
Altova.Types.DateTime dt1 = new Altova.Types.DateTime(2015, 10, 12, 10, 50, 33);
Console.WriteLine("My custom time is : " + dt1.ToString());

// Create an Altova DateTime object from parts (with UTC+60 minutes timezone)
Altova.Types.DateTime dt2 = new Altova.Types.DateTime(2015, 10, 12, 10, 50, 33, 60);
Console.WriteLine("My custom time with timezone is : " + dt2.ToString());

// Create an Altova DateTime object by parsing a string
Altova.Types.DateTime dt3 = Altova.Types.DateTime.Parse("2015-01-01T23:23:23");
Console.WriteLine("Time created from string: " + dt3.ToString());

// Create an Altova DateTime object by parsing a string formatted as schema date
Altova.Types.DateTime dt4 = Altova.Types.DateTime.Parse("2015-01-01", DateTimeFormat.W3_date);
Console.WriteLine("Time created from string formatted as schema date: " + dt4.ToString());
}

以下代码片段展示了设置DateTime对象的格式的各种方法：

protected static void DateTimeExample2()
{
// Create a DateTime object from the current system time
Altova.Types.DateTime dt = new Altova.Types.DateTime(System.DateTime.Now);

// Output the unformatted DateTime
Console.WriteLine("Unformatted time: " + dt.ToString());

// Output this DateTime formatted using various formats
Console.WriteLine("S_DateTime: " + dt.ToString(DateTimeFormat.S_DateTime));
Console.WriteLine("S_Days: " + dt.ToString(DateTimeFormat.S_Days));
Console.WriteLine("S_Seconds: " + dt.ToString(DateTimeFormat.S_Seconds));
Console.WriteLine("W3_date: " + dt.ToString(DateTimeFormat.W3_date));
Console.WriteLine("W3_dateTime: " + dt.ToString(DateTimeFormat.W3_dateTime));
Console.WriteLine("W3_gDay: " + dt.ToString(DateTimeFormat.W3_gDay));
Console.WriteLine("W3_gMonth: " + dt.ToString(DateTimeFormat.W3_gMonth));
Console.WriteLine("W3_gMonthDay: " + dt.ToString(DateTimeFormat.W3_gMonthDay));
Console.WriteLine("W3_gYear: " + dt.ToString(DateTimeFormat.W3_gYear));
Console.WriteLine("W3_gYearMonth: " + dt.ToString(DateTimeFormat.W3_gYearMonth));
Console.WriteLine("W3_time: " + dt.ToString(DateTimeFormat.W3_time));
}