DateTimePicker.CustomFormat Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de tekenreeks voor de aangepaste datum-/tijdnotatie op of stelt u deze in.
public:
property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
public string? CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As String
Waarde van eigenschap
Een tekenreeks die de aangepaste datum-/tijdnotatie vertegenwoordigt. De standaardwaarde is null.
Voorbeelden
In het volgende codevoorbeeld wordt de CustomFormat eigenschap zo ingesteld dat de DateTimePicker datum wordt weergegeven als '01 juni 2001 - vrijdag'. In deze code wordt ervan uitgegaan dat er een exemplaar van een DateTimePicker besturingselement is gemaakt op een Form.
public:
void SetMyCustomFormat()
{
// Set the Format type and the CustomFormat string.
dateTimePicker1->Format = DateTimePickerFormat::Custom;
dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
}
public void SetMyCustomFormat()
{
// Set the Format type and the CustomFormat string.
dateTimePicker1.Format = DateTimePickerFormat.Custom;
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}
Public Sub SetMyCustomFormat()
' Set the Format type and the CustomFormat string.
dateTimePicker1.Format = DateTimePickerFormat.Custom
dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub
Opmerkingen
Als u letterlijke tekenreeksen wilt weergeven die scheidingstekens voor datum en tijd bevatten of tekenreeksen wilt opmaken, moet u escapetekens in de subtekenreeks gebruiken. Als u bijvoorbeeld de datum wilt weergeven als '15 juni om 12:00 uur', stelt u de CustomFormat eigenschap in op 'MMMM dd 'at' t:mm tt'. Als de subtekenreeks 'at' niet is omsloten door escapetekens, is het resultaat '15 juni aP 12:00 pm' omdat het teken 't' wordt gelezen als de tekenreeks met één letter A.M./P.M. (zie de onderstaande tabel met opmaaktekenreeksen).
De notatietekenreeksen kunnen worden gecombineerd om de datum en tijd op te maken. Als u bijvoorbeeld de datum en tijd wilt weergeven als 15-06-2001 12:00 uur, moet deze eigenschap worden ingesteld op 'MM'/'dd'/'jjjj uu':'mm tt'. Zie Aangepaste tekenreeksen voor datum- en tijdnotatie voor meer informatie.
Note
De Format eigenschap moet zodanig worden ingesteld DateTimePickerFormat.Custom dat deze eigenschap van invloed is op de opmaak van de weergegeven datum en tijd.
De volgende tabel bevat alle geldige notatietekenreeksen en de bijbehorende beschrijvingen.
| Tekenreeks opmaken | Beschrijving |
|---|---|
| d | De dag met één of twee cijfers. |
| dd | De tweecijferige dag. Dagwaarden met één cijfer worden voorafgegaan door een 0. |
| ddd | De afkorting van drie tekens per week. |
| dddd | De volledige dag van de weeknaam. |
| h | Het uur met één of twee cijfers in de notatie van 12 uur. |
| hh | Het tweecijferige uur in de notatie van 12 uur. Waarden van één cijfer worden voorafgegaan door een 0. |
| H | Het uur met één of twee cijfers in de notatie van 24 uur. |
| HH | Het tweecijferige uur in de notatie van 24 uur. Waarden van één cijfer worden voorafgegaan door een 0. |
| m | De minuut van één of twee cijfers. |
| mm | De minuut van twee cijfers. Waarden van één cijfer worden voorafgegaan door een 0. |
| M | Het maandnummer van één of twee cijfers. |
| MM | Het maandnummer van twee cijfers. Waarden van één cijfer worden voorafgegaan door een 0. |
| MMM | De afkorting van drie tekens. |
| MMMM | De volledige maandnaam. |
| s | De seconden van één of twee cijfers. |
| ß | De tweecijferige seconden. Waarden van één cijfer worden voorafgegaan door een 0. |
| t | De afkorting van één letter A.M./P.M. (A.M. wordt weergegeven als 'A'). |
| tt | De afkorting van twee letters A.M./P.M. (A.M. wordt weergegeven als 'AM'). |
| y | Het jaar met één cijfer (2001 wordt weergegeven als '1'). |
| yy | De laatste twee cijfers van het jaar (2001 wordt weergegeven als '01'). |
| yyyy | Het volledige jaar (2001 wordt weergegeven als '2001'). |