导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

DateTimeOffset.Parse 方法 (String, IFormatProvider)

2013/12/13

使用指定的区域性特定格式信息,将日期和时间的指定字符串表示形式转换为其等效的 DateTimeOffset

Namespace:  System
程序集:  mscorlib(位于 mscorlib.dll 中)

public static DateTimeOffset Parse(
	string input,
	IFormatProvider formatProvider
)

参数

input
类型: System.String
包含要转换的日期和时间的字符串。
formatProvider
类型: System.IFormatProvider
一个对象,提供有关 input 的区域性特定的格式信息。

返回值

类型: System.DateTimeOffset
一个对象,它等效于 input 中包含的日期和时间,由 formatProvider 指定。

异常条件
ArgumentException

偏移量大于 14 小时或小于 -14 小时。

ArgumentNullException

inputnull

FormatException

input 不包含日期和时间的有效字符串表示形式。

- 或 -

input 包含不带日期或时间的偏移量值的字符串表示形式。

此方法分析一个具有三个元素的字符串,这三个元素可以按任何顺序出现并且由空白分隔。这三个元素如下表所示。

元素

示例

<日期>

"2/10/2007"

<时间>

"1:02:03 PM"

<偏移>

"-7:30:15"

虽然这些元素中的每个元素都是可选元素,但 <Offset> 不能单独出现。提供它时必须一起提供 <Date> 或 <Time>。如果缺少 <Date>,则其默认值为当前日期。如果缺少 <Time>,则其默认值为上午 12:00:00。如果缺少 <Offset>,则其默认值为本地时区的偏移量。<Offset> 可以表示与协调世界时 (UTC) 之间的正偏移量或负偏移量。在任何一种情况下,<Offset> 必须包括一个正负符号。

这三个元素的格式由 formatProvider 参数来定义,此参数可以是以下任意一项:

如果 formatprovidernull,则对应于当前区域性的 CultureInfo 对象用于确定日期和时间元素的特定有效格式。

<Offset> 中所使用的正号或负号必须为 + 或 -。它不是由 formatProvider 参数的 NumberFormatInfo 对象的 PositiveSignNegativeSign 属性来定义。

下面的示例分析针对“fr-fr”区域性进行格式设置的日期和时间字符串,并使用本地系统的默认“en-us”区域性来显示这些字符串。


DateTimeFormatInfo fmt = new CultureInfo("fr-fr").DateTimeFormat;
string dateString;
DateTimeOffset offsetDate;

dateString = "03-12-07";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
outputBlock.Text += String.Format("{0} returns {1}",
                  dateString,
                  offsetDate.ToString()) + "\n";

dateString = "15/09/07 08:45:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
outputBlock.Text += String.Format("{0} returns {1}",
                  dateString,
                  offsetDate.ToString()) + "\n";

dateString = "mar. 1 janvier 2008 1:00:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
outputBlock.Text += String.Format("{0} returns {1}",
                  dateString,
                  offsetDate.ToString()) + "\n";
// The example displays the following output:
//    03-12-07 returns 12/3/2007 12:00:00 AM -08:00
//    15/09/07 08:45:00 +1:00 returns 9/15/2007 8:45:00 AM +01:00
//    mar. 1 janvier 2008 1:00:00 +1:00 returns 1/1/2008 1:00:00 AM +01:00                              


Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2014 Microsoft