DateTimeOffset.TryParse Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengonversi representasi string yang ditentukan dari tanggal dan waktu ke DateTimeOffset yang setara.
Overload
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) |
Mencoba mengonversi representasi string tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset) |
Mencoba mengonversi representasi rentang tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil. |
TryParse(String, IFormatProvider, DateTimeOffset) |
Mencoba mengurai string ke dalam nilai. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset) |
Mencoba mengurai rentang karakter ke dalam nilai. |
TryParse(ReadOnlySpan<Char>, DateTimeOffset) |
Mencoba mengonversi representasi rentang tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil. |
TryParse(String, DateTimeOffset) |
Mencoba mengonversi representasi string tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil. |
TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengonversi representasi string tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil.
public:
static bool TryParse(System::String ^ input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParse (string input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
public static bool TryParse (string? input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParse : string * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParse (input As String, formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean
Parameter
- input
- String
String yang berisi tanggal dan waktu untuk dikonversi.
- formatProvider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang input
.
- styles
- DateTimeStyles
Kombinasi bitwise dari nilai enumerasi yang menunjukkan format yang diizinkan dari input
.
- result
- DateTimeOffset
Saat metode kembali, berisi DateTimeOffset nilai yang setara dengan tanggal dan waktu input
, jika konversi berhasil, atau DateTimeOffset.MinValue, jika konversi gagal. Konversi gagal jika input
parameter adalah null
atau tidak berisi representasi string yang valid dari tanggal dan waktu. Parameter ini diteruskan tanpa diinisialisasi.
Mengembalikan
true
jika parameter berhasil dikonversi input
; jika tidak, false
.
Pengecualian
styles
menyertakan nilai yang tidak ditentukan DateTimeStyles .
-atau-
NoCurrentDateDefault tidak didukung.
-atau-
styles
mencakup nilai yang saling eksklusif DateTimeStyles .
Contoh
Contoh berikut memanggil TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) metode dengan berbagai nilai untuk mengurai DateTimeStyles beberapa string dengan berbagai format tanggal dan waktu.
string dateString;
DateTimeOffset parsedDate;
dateString = "05/01/2008 6:00:00";
// Assume time is local
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
DateTimeStyles.AssumeLocal,
out parsedDate))
Console.WriteLine("'{0}' was converted to {1}.",
dateString, parsedDate.ToString());
else
Console.WriteLine("Unable to parse '{0}'.", dateString);
// Assume time is UTC
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
DateTimeStyles.AssumeUniversal,
out parsedDate))
Console.WriteLine("'{0}' was converted to {1}.",
dateString, parsedDate.ToString());
else
Console.WriteLine("Unable to parse '{0}'.", dateString);
// Parse and convert to UTC
dateString = "05/01/2008 6:00:00AM +5:00";
if (DateTimeOffset.TryParse(dateString, null as IFormatProvider,
DateTimeStyles.AdjustToUniversal,
out parsedDate))
Console.WriteLine("'{0}' was converted to {1}.",
dateString, parsedDate.ToString());
else
Console.WriteLine("Unable to parse '{0}'.", dateString);
// The example displays the following output to the console:
// '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
// '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
// '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.
let dateString = "05/01/2008 6:00:00"
// Assume time is local
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AssumeLocal) with
| true, parsedDate ->
printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
printfn $"Unable to parse '{dateString}'."
// Assume time is UTC
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AssumeUniversal) with
| true, parsedDate ->
printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
printfn $"Unable to parse '{dateString}'."
// Parse and convert to UTC
let dateString = "05/01/2008 6:00:00AM +5:00"
match DateTimeOffset.TryParse(dateString, null, DateTimeStyles.AdjustToUniversal) with
| true, parsedDate ->
printfn $"'{dateString}' was converted to {parsedDate}."
| _ ->
printfn $"Unable to parse '{dateString}'."
// The example displays the following output to the console:
// '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
// '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
// '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.
Dim dateString As String
Dim parsedDate As DateTimeOffset
dateString = "05/01/2008 6:00:00"
' Assume time is local
If DateTimeOffset.TryParse(dateString, Nothing, _
DateTimeStyles.AssumeLocal, _
parsedDate) Then
Console.WriteLine("'{0}' was converted to {1}.", _
dateString, parsedDate.ToString())
Else
Console.WriteLine("Unable to parse '{0}'.", dateString)
End If
' Assume time is UTC
If DateTimeOffset.TryParse(dateString, Nothing, _
DateTimeStyles.AssumeUniversal, _
parsedDate) Then
Console.WriteLine("'{0}' was converted to {1}.", _
dateString, parsedDate.ToString())
Else
Console.WriteLine("Unable to parse '{0}'.", dateString)
End If
' Parse and convert to UTC
dateString = "05/01/2008 6:00:00AM +5:00"
If DateTimeOffset.TryParse(dateString, Nothing, _
DateTimeStyles.AdjustToUniversal, _
parsedDate) Then
Console.WriteLine("'{0}' was converted to {1}.", _
dateString, parsedDate.ToString())
Else
Console.WriteLine("Unable to parse '{0}'.", dateString)
End If
' The example displays the following output to the console:
' '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM -07:00.
' '05/01/2008 6:00:00' was converted to 5/1/2008 6:00:00 AM +00:00.
' '05/01/2008 6:00:00AM +5:00' was converted to 5/1/2008 1:00:00 AM +00:00.
Keterangan
Kelebihan TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) metode ini seperti DateTimeOffset.Parse(String, IFormatProvider, DateTimeStyles) metode , kecuali bahwa metode tersebut tidak memberikan pengecualian jika konversi gagal. Metode ini menguraikan string dengan tiga elemen yang dapat muncul dalam urutan apa pun dan dibatasi oleh spasi kosong. Ketiga elemen ini diperlihatkan dalam tabel berikut.
Elemen | Contoh |
---|---|
<Tanggal> | "2/10/2007" |
<Waktu> | "13:02:03" |
<Offset> | "-7:30" |
Meskipun masing-masing elemen ini bersifat opsional, <Offset> tidak dapat muncul dengan sendirinya. Ini harus disediakan bersama dengan <Tanggal> atau <Waktu>. Jika <Tanggal> hilang, nilai defaultnya adalah hari ini. Jika <Tanggal> ada tetapi komponen tahunnya hanya terdiri dari dua digit, itu dikonversi ke tahun di provider
kalender parameter saat ini berdasarkan nilai Calendar.TwoDigitYearMax properti. Jika <Waktu> hilang, nilai defaultnya adalah 12:00:00 AM. Jika <Offset> hilang, nilai defaultnya adalah offset zona waktu lokal, atau Zero jika DateTimeStyles.AdjustToUniversal nilai atau DateTimeStyles.AssumeUniversal ditentukan dalam styles
. Jika <Offset> ada, itu dapat mewakili offset negatif atau positif dari Waktu Universal Terkoordinasi (UTC). Dalam kedua kasus, <Offset> harus menyertakan simbol tanda atau metode mengembalikan false
.
String input
diurai dengan menggunakan informasi pemformatan khusus budaya dalam objek yang DateTimeFormatInfo disediakan oleh formatProvider
parameter . Parameter formatProvider
dapat berupa salah satu dari yang berikut:
Objek CultureInfo yang mewakili budaya yang pemformatannya digunakan dalam
input
. Objek DateTimeFormatInfo yang CultureInfo.DateTimeFormat dikembalikan oleh properti menentukan format yang digunakan dalaminput
.Objek DateTimeFormatInfo yang menentukan format data tanggal dan waktu.
Selain itu, setiap elemen dapat dibatasi dengan spasi putih di depan atau di belakang, dan <komponen Tanggal> dan <Waktu> dapat mencakup spasi putih dalam (seperti 6: 00:00). Hanya komponen Offset> yang <tidak dapat menyertakan spasi kosong dalam.
Jika provider
adalah null
, CultureInfo objek yang sesuai dengan budaya saat ini digunakan.
Tanda positif atau negatif yang digunakan dalam <Offset> harus + atau -. Ini tidak didefinisikan oleh PositiveSign properti atau NegativeSign objek yang NumberFormatInfo dikembalikan oleh formatprovider
properti parameter NumberFormat .
Anggota DateTimeStyles enumerasi berikut didukung:
Anggota DateTimeStyles | Komentar |
---|---|
AdjustToUniversal | Mengurai string yang diwakili oleh input dan, jika perlu, mengonversinya menjadi UTC. Ini setara dengan mengurai string, dan kemudian memanggil metode objek ToUniversalTime() yang dikembalikan. |
AllowInnerWhite | Meskipun valid, nilai ini diabaikan. Spasi putih dalam diperbolehkan di <komponen Tanggal> dan <Waktu> . |
AllowLeadingWhite | Meskipun valid, nilai ini diabaikan. Spasi kosong di depan diperbolehkan di depan setiap komponen dalam string yang diurai. |
AllowTrailingWhite | Meskipun valid, nilai ini diabaikan. Spasi putih berikutnya diperbolehkan di depan setiap komponen dalam string yang diurai. |
AllowWhiteSpaces | Ini adalah perilaku default. Ini tidak dapat ditimpa dengan memasok nilai enumerasi yang lebih ketat DateTimeStyles , seperti DateTimeStyles.None. |
AssumeLocal | Menunjukkan bahwa, jika input parameter tidak memiliki <elemen Offset> , offset zona waktu lokal harus disediakan. Ini adalah perilaku TryParse(String, IFormatProvider, DateTimeStyles, DateTimeOffset) default metode . |
AssumeUniversal | Menunjukkan bahwa, jika input parameter tidak memiliki <elemen Offset> , offset UTC (00:00) harus disediakan. |
None | Meskipun valid, nilai ini diabaikan dan tidak berpengaruh. |
RoundtripKind |
DateTimeOffset Karena struktur tidak menyertakan Kind properti, nilai ini tidak berpengaruh. |
Hanya nilai yang DateTimeStyles.NoCurrentDateDefault tidak didukung.
ArgumentException dilemparkan jika nilai ini disertakan dalam styles
parameter .
Lihat juga
Berlaku untuk
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengonversi representasi rentang tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil.
public:
static bool TryParse(ReadOnlySpan<char> input, IFormatProvider ^ formatProvider, System::Globalization::DateTimeStyles styles, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParse (ReadOnlySpan<char> input, IFormatProvider? formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
public static bool TryParse (ReadOnlySpan<char> input, IFormatProvider formatProvider, System.Globalization.DateTimeStyles styles, out DateTimeOffset result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * System.Globalization.DateTimeStyles * DateTimeOffset -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), formatProvider As IFormatProvider, styles As DateTimeStyles, ByRef result As DateTimeOffset) As Boolean
Parameter
- input
- ReadOnlySpan<Char>
Rentang yang berisi karakter yang mewakili tanggal dan waktu untuk dikonversi.
- formatProvider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang input
.
- styles
- DateTimeStyles
Kombinasi bitwise dari nilai enumerasi yang menunjukkan format yang diizinkan dari input
.
- result
- DateTimeOffset
Saat metode kembali, berisi DateTimeOffset nilai yang setara dengan tanggal dan waktu input
, jika konversi berhasil, atau DateTimeOffset.MinValue, jika konversi gagal. Konversi gagal jika input
parameter adalah null
atau tidak berisi representasi string yang valid dari tanggal dan waktu. Parameter ini diteruskan tanpa diinisialisasi.
Mengembalikan
true
jika parameter berhasil dikonversi input
; jika tidak, false
.
Berlaku untuk
TryParse(String, IFormatProvider, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengurai string ke dalam nilai.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] DateTimeOffset % result) = IParsable<DateTimeOffset>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out DateTimeOffset result);
static member TryParse : string * IFormatProvider * DateTimeOffset -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As DateTimeOffset) As Boolean
Parameter
- s
- String
String yang akan diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
- result
- DateTimeOffset
Ketika metode ini kembali, berisi hasil penguraian yang berhasil s
atau nilai yang tidak terdefinisi pada kegagalan.
Mengembalikan
true
jika s
berhasil diurai; jika tidak, false
.
Berlaku untuk
TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengurai rentang karakter ke dalam nilai.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] DateTimeOffset % result) = ISpanParsable<DateTimeOffset>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out DateTimeOffset result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * DateTimeOffset -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As DateTimeOffset) As Boolean
Parameter
- s
- ReadOnlySpan<Char>
Rentang karakter untuk diurai.
- provider
- IFormatProvider
Objek yang menyediakan informasi pemformatan khusus budaya tentang s
.
- result
- DateTimeOffset
Ketika metode ini kembali, berisi hasil penguraian yang berhasil s
, atau nilai yang tidak terdefinisi pada kegagalan.
Mengembalikan
true
jika s
berhasil diurai; jika tidak, false
.
Berlaku untuk
TryParse(ReadOnlySpan<Char>, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengonversi representasi rentang tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil.
public:
static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParse (ReadOnlySpan<char> input, out DateTimeOffset result);
static member TryParse : ReadOnlySpan<char> * DateTimeOffset -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As DateTimeOffset) As Boolean
Parameter
- input
- ReadOnlySpan<Char>
Rentang yang berisi karakter yang mewakili tanggal dan waktu untuk dikonversi.
- result
- DateTimeOffset
Ketika metode kembali, berisi DateTimeOffset yang setara dengan tanggal dan waktu input
, jika konversi berhasil, atau DateTimeOffset.MinValue, jika konversi gagal. Konversi gagal jika input
parameter adalah null
atau tidak berisi representasi string yang valid dari tanggal dan waktu. Parameter ini diteruskan tanpa diinisialisasi.
Mengembalikan
true
jika parameter berhasil dikonversi input
; jika tidak, false
.
Berlaku untuk
TryParse(String, DateTimeOffset)
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
- Sumber:
- DateTimeOffset.cs
Mencoba mengonversi representasi string tertentu dari tanggal dan waktu ke DateTimeOffset yang setara, dan mengembalikan nilai yang menunjukkan apakah konversi berhasil.
public:
static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] DateTimeOffset % result);
public static bool TryParse (string input, out DateTimeOffset result);
public static bool TryParse (string? input, out DateTimeOffset result);
static member TryParse : string * DateTimeOffset -> bool
Public Shared Function TryParse (input As String, ByRef result As DateTimeOffset) As Boolean
Parameter
- input
- String
String yang berisi tanggal dan waktu untuk dikonversi.
- result
- DateTimeOffset
Ketika metode kembali, berisi DateTimeOffset yang setara dengan tanggal dan waktu input
, jika konversi berhasil, atau DateTimeOffset.MinValue, jika konversi gagal. Konversi gagal jika input
parameter adalah null
atau tidak berisi representasi string yang valid dari tanggal dan waktu. Parameter ini diteruskan tanpa diinisialisasi.
Mengembalikan
true
jika parameter berhasil dikonversi input
; jika tidak, false
.
Contoh
Contoh berikut memanggil TryParse(String, DateTimeOffset) metode untuk mengurai beberapa string dengan berbagai format tanggal dan waktu.
DateTimeOffset parsedDate;
string dateString;
// String with date only
dateString = "05/01/2008";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
Console.WriteLine("{0} was converted to {1}.",
dateString, parsedDate);
// String with time only
dateString = "11:36 PM";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
Console.WriteLine("{0} was converted to {1}.",
dateString, parsedDate);
// String with date and offset
dateString = "05/01/2008 +7:00";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
Console.WriteLine("{0} was converted to {1}.",
dateString, parsedDate);
// String with day abbreviation
dateString = "Thu May 01, 2008";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
Console.WriteLine("{0} was converted to {1}.",
dateString, parsedDate);
// String with date, time with AM/PM designator, and offset
dateString = "5/1/2008 10:00 AM -07:00";
if (DateTimeOffset.TryParse(dateString, out parsedDate))
Console.WriteLine("{0} was converted to {1}.",
dateString, parsedDate);
// if (run on 3/29/07, the example displays the following output
// to the console:
// 05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
// 11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
// 05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
// Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
// 5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.
// String with date only
let dateString = "05/01/2008"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()
// String with time only
let dateString = "11:36 PM"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()
// String with date and offset
let dateString = "05/01/2008 +7:00"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()
// String with day abbreviation
let dateString = "Thu May 01, 2008"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()
// String with date, time with AM/PM designator, and offset
let dateString = "5/1/2008 10:00 AM -07:00"
match DateTimeOffset.TryParse dateString with
| true, parsedDate ->
printfn $"{dateString} was converted to {parsedDate}."
| _ -> ()
// if (run on 3/29/07, the example displays the following output
// to the console:
// 05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
// 11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
// 05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
// Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
// 5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.
Dim parsedDate As DateTimeOffset
Dim dateString As String
' String with date only
dateString = "05/01/2008"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
Console.WriteLine("{0} was converted to {1}.", _
dateString, parsedDate)
' String with time only
dateString = "11:36 PM"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
Console.WriteLine("{0} was converted to {1}.", _
dateString, parsedDate)
' String with date and offset
dateString = "05/01/2008 +7:00"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
Console.WriteLine("{0} was converted to {1}.", _
dateString, parsedDate)
' String with day abbreviation
dateString = "Thu May 01, 2008"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
Console.WriteLine("{0} was converted to {1}.", _
dateString, parsedDate)
' String with date, time with AM/PM designator, and offset
dateString = "5/1/2008 10:00 AM -07:00"
If DateTimeOffset.TryParse(dateString, parsedDate) Then _
Console.WriteLine("{0} was converted to {1}.", _
dateString, parsedDate)
' If run on 3/29/07, the example displays the following output
' to the console:
' 05/01/2008 was converted to 5/1/2008 12:00:00 AM -07:00.
' 11:36 PM was converted to 3/29/2007 11:36:00 PM -07:00.
' 05/01/2008 +7:00 was converted to 5/1/2008 12:00:00 AM +07:00.
' Thu May 01, 2008 was converted to 5/1/2008 12:00:00 AM -07:00.
' 5/1/2008 10:00 AM -07:00 was converted to 5/1/2008 10:00:00 AM -07:00.
Keterangan
Kelebihan TryParse(String, DateTimeOffset) metode ini seperti DateTimeOffset.Parse(String) metode , kecuali bahwa metode tersebut tidak memberikan pengecualian jika konversi gagal. Ini mengurai string dengan tiga elemen yang dapat muncul dalam urutan apa pun dan dibatasi oleh spasi kosong. Ketiga elemen ini diperlihatkan dalam tabel berikut.
Elemen | Contoh |
---|---|
<Tanggal> | "2/10/2007" |
<Waktu> | "13:02:03" |
<Offset> | "-7:30" |
Meskipun masing-masing elemen ini bersifat opsional, <Offset> tidak dapat muncul dengan sendirinya. Ini harus disediakan bersama dengan <Tanggal> atau <Waktu>. Jika <Tanggal> hilang, nilai defaultnya adalah hari ini. Jika <Tanggal> ada tetapi komponen tahunnya hanya terdiri dari dua digit, itu dikonversi menjadi satu tahun di kalender budaya saat ini berdasarkan nilai Calendar.TwoDigitYearMax properti. Jika <Waktu> hilang, nilai defaultnya adalah 12:00:00 AM. Jika <Offset> hilang, nilai defaultnya adalah offset zona waktu lokal. Jika <Offset> ada, itu dapat mewakili offset negatif atau positif dari Waktu Universal Terkoordinasi (UTC). Dalam kedua kasus, <Offset> harus menyertakan simbol tanda atau metode mengembalikan false
.
String input
diurai dengan menggunakan informasi pemformatan dalam objek yang DateTimeFormatInfo diinisialisasi untuk budaya saat ini. Untuk mengurai string yang berisi pemformatan yang ditunjuk yang tidak selalu sesuai dengan budaya saat ini, gunakan TryParseExact metode dan berikan penentu format.
Lihat juga
- Parse
- Sampel: Utilitas Pemformatan .NET Core WinForms (C#)
- Sampel: Utilitas Pemformatan .NET Core WinForms (Visual Basic)