Syntax der Formatierung von Zeichenketten innerhalb von vMix

vMix verwendet das Microsoft eigene Schema zur Formatierung von Zeichenketten, welches wie folgt funktioniert.

WICHTIG Die hier folgende Beschreibung bezieht sich beispielhaft auf die Einstellung: Filename Format
In anderen Einstellungsfeldern können die zur Verfügung stehenden Variablen anders definiert sein!

Mit der Zeichenfolge {Variable} wird der Wert der Variable ausgegeben.
Variablen welche eine Zeitangabe beinhalten können zusätzlich auch Formatiert werden. Alle anderen Variablen sollten sinnvollerweise nicht zusätzlich formatiert werden.

In den Filename Format Einstellungen existieren die folgenden Variablen:

z.B. wird in diesem Falle ein {0} durch den Dateiname aus den Record Einstellungen ersetzt.

Die Variable 1 bzw. die Zeichenfolge {1} wird durch die aktuelle Zeit (Datum und Uhrzeit) ersetzt. Diese Zeitangabe kann zusätzlich noch weiter Formatiert werden. Hierzu muss nach der Variable ein : eingefügt werden. z.B. {1:<FORMATIERUNG>}. Daraufhin wird diese Zeichenfolge durch eine entsprechend Formatierte Zeit und Datumsformatierung ersetzt.

z.B. {1:HHmmss} wird durch die Stunde, Minute und Sekunde ersetzt -> 143059
z.B. {1:HH:mm:ss} wird durch die Stunde, Minute und Sekunde mit dem Uhrzeittrenner ersetzt -> 14:30:59
z.B. {1:HH'_'mm'_'ss} wird durch die Stunde, Minute und Sekunde mit einem manuell definierten Trenner ersetzt -> 14_30_59

Auch sind mehrfache Kombinationen möglich.
z.B. {1:HH}_{1:mm}_{1:ss} entspricht einem {1:HH'_'mm'_'ss}

Wichtig zu wissen ist, das die Sonderzeichen : (Doppelpunkt), . (Punkt), ... usw. NUR innerhalb der geschweiften Klammern von Relevanz sind. Außerhalb werden diese als normales Zeichen wiedergegeben, und nicht interpretiert bzw. ersetzt.


Countdown
Im Titel Editor gibt es noch eine Besonderheit in der Formatierung. So besteht die Möglichkeit einen Countdown einzurichten und diesen zu Formatieren.

Aber zuerst einmal, der Titeleditor besitzt folgende Variablen:

Die Formatierung des Countdowns im Titeleditor sieht wie folgt aus:
{0:<ZIELZEIT>|<FORMATIERUNG>}

Regulär kann die <ZIELZEIT> als einfache Uhrzeitangabe im englischem Format erfolgen: 3:00 PM In diesem Falle besteht die Zeit aus Stunde und Minute.

Auch ist eine erweiterte Angabe möglich: 3:00:00 PM für Stunde, Minute und Sekunde.

Erreicht der Countdown hier die Zielzeit, bleibt der Countdown bei 00:00:00 stehen.

Möchte man einen Countdown mit mehr als 24 Stunden einrichten, muss zusätzlich noch ein Datum angegeben werden. Dies hat wie folgt auszusehen: <TAG>/<MONAT>/<JAHR> <STUNDE>:<MINUTE>... z.B. 06/04/2023 3:00:00 PM

Als Formatierter Text sieht dies wie folgt aus: {0:06/04/2023 3:00:00 PM|dd H:mm:ss}

Wichtig zu wissen ist, dass das Datum der ZIELZEIT von der aktuellen Zeit abgezogen wird! Die einzigst sinnvolle Formatierung wäre die Nutzung von "d" und "dd" für Tage im Formatierungsabschnitt. Monate und Jahre würden fehlerhaft dargestellt.






Weitere Informationen finden sich hier: https://learn.microsoft.com/de-de/dotnet/standard/base-types/custom-date-and-time-format-strings