DateTimeOffset.Parse Yöntem

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input);

public static DateTimeOffset Parse (string input);

static member Parse : string -> DateTimeOffset

Public Shared Function Parse (input As String) As DateTimeOffset

Parametreler

Döndürülenler

içinde bulunan inputtarih ve saate eşdeğer bir nesne.

Özel durumlar

Örnekler

Aşağıdaki örnek, birkaç tarih ve saat dizesini ayrıştırmak için yöntemini çağırır Parse(String) . Örnek, kültürü en-us olan bir sistemde 22 Mart 2007 çıkışını içerir.

string dateString;
DateTimeOffset offsetDate;

// String with date only
dateString = "05/01/2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with time only
dateString = "11:36 PM";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with date and offset
dateString = "05/01/2008 +1:00";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with day abbreviation
dateString = "Thu May 01, 2008";
offsetDate = DateTimeOffset.Parse(dateString);
Console.WriteLine(offsetDate.ToString());

// String with date only
let dateString = "05/01/2008"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with time only
let dateString = "11:36 PM"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with date and offset
let dateString = "05/01/2008 +1:00"
let offsetDate = DateTimeOffset.Parse dateString
printfn $"{offsetDate}"

// String with day abbreviation
let dateString = "Thu May 01, 2008"
let offsetDate = DateTimeOffset.Parse(dateString)
printfn $"{offsetDate}"

Dim dateString As String
Dim offsetDate As DateTimeOffset

' String with date only
dateString = "05/01/2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00  

' String with time only
dateString = "11:36 PM"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 3/26/2007 11:36:00 PM -07:00

' String with date and offset 
dateString = "05/01/2008 +7:00"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM +07:00

' String with day abbreviation
dateString = "Thu May 01, 2008"
offsetDate = DateTimeOffset.Parse(dateString)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 12:00:00 AM -07:00

Açıklamalar

Parse(String) herhangi bir sırada görünebilen ve boşlukla sınırlandırılmış üç öğe içeren bir dizeyi ayrıştırıyor. Bu üç öğe aşağıdaki tabloda gösterildiği gibi gösterilir.

Bu öğelerin her biri isteğe bağlı olsa da, <Uzaklık> tek başına görüntülenemez. Tarih> veya <Saat> ile <birlikte sağlanmalıdır. Tarih> eksikse<, varsayılan değeri geçerli gündür. Saat> eksikse <varsayılan değeri 12:00:00'dir. Tarih> mevcutsa ancak yıl bileşeni yalnızca iki basamakdan oluşuyorsa<, özelliğin değerine Calendar.TwoDigitYearMax göre geçerli kültürün geçerli takviminde bir yıla dönüştürülür. Uzaklık> eksikse<, varsayılan değeri yerel saat diliminin uzaklığıdır. <Uzaklık> , Eşgüdümlü Evrensel Saat'ten (UTC) negatif veya pozitif bir uzaklığı temsil edebilir. Her iki durumda da Uzaklık <> bir işaret simgesi içermelidir.

Dize input , geçerli kültür için başlatılan bir DateTimeFormatInfo nesnedeki biçimlendirme bilgileri kullanılarak ayrıştırılır. Geçerli kültürün biçimlendirmesine karşılık gelmiyor olması gerekmeyen belirlenmiş biçimlendirme içeren bir dizeyi ayrıştırmak için yöntemini kullanın ParseExact ve bir biçim belirtici sağlayın.

Ayrıca bkz.

• TryParse
• ParseExact

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> DateTimeOffset

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As DateTimeOffset

Parametreler

Döndürülenler

ayrıştırma sişleminin sonucu.

Uygulamalar

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider);

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider) = IParsable<DateTimeOffset>::Parse;

public static DateTimeOffset Parse (string input, IFormatProvider formatProvider);

public static DateTimeOffset Parse (string input, IFormatProvider? formatProvider);

static member Parse : string * IFormatProvider -> DateTimeOffset

Public Shared Function Parse (input As String, formatProvider As IFormatProvider) As DateTimeOffset

Parametreler

Döndürülenler

tarafından formatProviderbelirtildiği gibi içinde bulunan inputtarih ve saatle eşdeğer bir nesne.

Uygulamalar

Özel durumlar

Örnekler

Aşağıdaki örnek fr-fr kültürü için biçimlendirilmiş tarih ve saat dizelerini ayrıştırır ve yerel sistemin varsayılan en-us kültürünü kullanarak görüntüler.

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

dateString = "03-12-07";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());

dateString = "15/09/07 08:45:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());

dateString = "mar. 1 janvier 2008 1:00:00 +1:00";
offsetDate = DateTimeOffset.Parse(dateString, fmt);
Console.WriteLine("{0} returns {1}",
                  dateString,
                  offsetDate.ToString());
// The example displays the following output to the console:
//    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

let fmt = CultureInfo("fr-fr").DateTimeFormat
let dateString = "03-12-07"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "15/09/07 08:45:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

let dateString = "mar. 1 janvier 2008 1:00:00 +1:00"
let offsetDate = DateTimeOffset.Parse(dateString, fmt)
printfn $"{dateString} returns {offsetDate}"

// The example displays the following output to the console:
//    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

Dim fmt As DateTimeFormatInfo = New CultureInfo("fr-fr").DateTimeFormat
Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "03-12-07"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "15/09/07 08:45:00 +1:00"
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())

dateString = "mar. 1 janvier 2008 1:00:00 +1:00" 
offsetDate = DateTimeOffset.Parse(dateString, fmt)
Console.WriteLine("{0} returns {1}", _
                  dateString, _
                  offsetDate.ToString())
' The example displays the following output to the console:
'    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

Açıklamalar

Bu yöntem, herhangi bir sırada görünebilen ve boşlukla sınırlandırılmış üç öğe içeren bir dizeyi ayrıştırıyor. Bu üç öğe aşağıdaki tabloda gösterilmiştir.

Bu öğelerin her biri isteğe bağlı olsa da, <Uzaklık> tek başına görüntülenemez. Tarih> veya <Saat> ile <birlikte sağlanmalıdır. Tarih> eksikse<, varsayılan değeri geçerli gündür. Tarih> mevcutsa ancak yıl bileşeni yalnızca iki basamakdan oluşuyorsa<, özelliğin değerine Calendar.TwoDigitYearMax göre parametrenin provider geçerli takviminde bir yıla dönüştürülür. Saat> eksikse <varsayılan değeri 12:00:00'dir. Uzaklık> eksikse<, varsayılan değeri yerel saat diliminin uzaklığıdır. <Uzaklık> , Eşgüdümlü Evrensel Saat'ten (UTC) negatif veya pozitif bir uzaklığı temsil edebilir. Her iki durumda da Uzaklık <> bir işaret simgesi içermelidir.

Bu üç öğe biçimi parametresi tarafından formatProvider tanımlanır ve bu da aşağıdakilerden biri olabilir:

• CultureInfo parametresinde input biçimlendirmesi kullanılan kültürü temsil eden bir nesne. DateTimeFormatInfo özelliği tarafından döndürülen nesne, CultureInfo.DateTimeFormat içinde inputkullanılan biçimlendirmeyi tanımlar.

• DateTimeFormatInfo Tarih ve saat verilerinin biçimini tanımlayan nesne.

ise formatprovidernull, CultureInfo geçerli kültüre karşılık gelen nesne kullanılır.

Uzaklık'ta <> kullanılan pozitif veya negatif işareti + veya - olmalıdır. Parametresinin nesnesinin PositiveSignNumberFormatInfoformatProvider veya NegativeSign özellikleri tarafından tanımlanmaz.

Ayrıca bkz.

• TryParse
• ParseExact

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

public static DateTimeOffset Parse (ReadOnlySpan<char> input, IFormatProvider? formatProvider = default, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);

public static DateTimeOffset Parse (ReadOnlySpan<char> input, IFormatProvider formatProvider = default, System.Globalization.DateTimeStyles styles = System.Globalization.DateTimeStyles.None);

static member Parse : ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset

Public Shared Function Parse (input As ReadOnlySpan(Of Char), Optional formatProvider As IFormatProvider = Nothing, Optional styles As DateTimeStyles = System.Globalization.DateTimeStyles.None) As DateTimeOffset

Parametreler

Döndürülenler

ve stylestarafından formatProvider belirtildiği gibi içinde input yer alan tarih ve saate eşdeğer bir nesne.

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

Kaynak:

DateTimeOffset.cs

public:
 static DateTimeOffset Parse(System::String ^ input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles);

public static DateTimeOffset Parse (string input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles);

public static DateTimeOffset Parse (string input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles);

static member Parse : string * IFormatProvider * System.Globalization.DateTimeStyles -> DateTimeOffset

Public Shared Function Parse (input As String, formatProvider As IFormatProvider, styles As DateTimeStyles) As DateTimeOffset

Parametreler

Döndürülenler

ve stylestarafından formatProvider belirtildiği gibi içinde input yer alan tarih ve saate eşdeğer bir nesne.

Özel durumlar

Örnekler

Aşağıdaki örnekte, , DateTimeStyles.AssumeUniversalve değerlerini yönteminin parametresine geçirmenin stylesDateTimeStyles.AssumeLocaletkisi gösterilmektedir Parse(String, IFormatProvider, DateTimeStyles)DateTimeStyles.AdjustToUniversal.

string dateString;
DateTimeOffset offsetDate;

dateString = "05/01/2008 6:00:00";
// Assume time is local
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC
dateString = "05/01/2008 6:00:00AM +5:00";
offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal);
Console.WriteLine(offsetDate.ToString());   // Displays 5/1/2008 1:00:00 AM +00:00

let dateString = "05/01/2008 6:00:00"
// Assume time is local
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeLocal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM -07:00

// Assume time is UTC
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AssumeUniversal)
printfn $"{offsetDate}"   // Displays 5/1/2008 6:00:00 AM +00:00

// Parse and convert to UTC
let dateString = "05/01/2008 6:00:00AM +5:00"
let offsetDate = DateTimeOffset.Parse(dateString, null, DateTimeStyles.AdjustToUniversal)
printfn $"{offsetDate}"   // Displays 5/1/2008 1:00:00 AM +00:00

Dim dateString As String
Dim offsetDate As DateTimeOffset

dateString = "05/01/2008 6:00:00"
' Assume time is local 
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeLocal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM -07:00

' Assume time is UTC
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AssumeUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 6:00:00 AM +00:00

' Parse and convert to UTC 
dateString = "05/01/2008 6:00:00AM +5:00"
offsetDate = DateTimeOffset.Parse(dateString, Nothing, DateTimeStyles.AdjustToUniversal)
Console.WriteLine(offsetDate.ToString())   ' Displays 5/1/2008 1:00:00 AM +00:00

Açıklamalar

Bu yöntem, herhangi bir sırada görünebilen ve boşlukla sınırlandırılmış üç öğe içeren bir dizeyi ayrıştırıyor. Bu üç öğe aşağıdaki tabloda gösterilmiştir.

Bu öğelerin her biri isteğe bağlı olsa da, <Uzaklık> tek başına görüntülenemez. Tarih> veya <Saat> ile <birlikte sağlanmalıdır. Tarih> eksikse<, varsayılan değeri geçerli gündür. Tarih> mevcutsa ancak yıl bileşeni yalnızca iki basamakdan oluşuyorsa<, özelliğin değerine Calendar.TwoDigitYearMax göre parametrenin provider geçerli takviminde bir yıla dönüştürülür. Saat> eksikse <varsayılan değeri 12:00:00'dir. Uzaklık> eksikse<, varsayılan değeri yerel saat diliminin uzaklığıdır veya TimeSpan.ZeroDateTimeStyles.AdjustToUniversal veya DateTimeStyles.AssumeUniversal değeri parametresinde styles belirtilmişse. <Uzaklık> varsa, Eşgüdümlü Evrensel Saat'ten (UTC) negatif veya pozitif bir uzaklığı temsil edebilir. Her iki durumda da Uzaklık <> bir işaret simgesi içermelidir.

Bu üç öğe biçimi parametresi tarafından formatProvider tanımlanır ve bu da aşağıdakilerden biri olabilir:

• CultureInfo parametresinde input biçimlendirmesi kullanılan kültürü temsil eden bir nesne. DateTimeFormatInfo özelliği tarafından döndürülen nesne, CultureInfo.DateTimeFormat içinde inputkullanılan biçimlendirmeyi tanımlar.

• DateTimeFormatInfo Tarih ve saat verilerinin biçimini tanımlayan nesne.

Her öğe baştaki veya sondaki boşlukla da kapatılabilir ve <Tarih> ve <Saat> öğeleri iç boşluk (6: 00:00 gibi) içerebilir. <Yalnızca Offset> bileşeni iç boşluk içeremez.

ise formatprovidernull, CultureInfo geçerli kültüre karşılık gelen nesne kullanılır.

Uzaklık'ta <> kullanılan pozitif veya negatif işareti + veya - olmalıdır. Parametresi tarafından döndürülen nesnenin PositiveSignNumberFormatInfo veya NegativeSign özellikleri tarafından formatProvider tanımlanmaz.

Aşağıdaki tabloda, desteklenen sabit listesi üyeleri System.Globalization.DateTimeStyles gösterilmektedir.

DateTimeStyles.NoCurrentDateDefault Yalnızca değer desteklenmez. Bu değer parametresine styles dahil edilirse bir ArgumentException oluşturulur.

Ayrıca bkz.

• TryParse
• ParseExact