SPFieldDateTime.GetFieldValueAsText-Methode (DateTime, SPWeb, SPDateFormat)
Gibt den angegebenen felddatenwert als Zeichenfolge basierend auf dem angegebenen Datum und Time-Wert, übergeordneten Website und SharePoint Foundation Datumsformat im Format (Coordinated Universal Time, UTC) ausgedrückt.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Shared Function GetFieldValueAsText ( _
data As DateTime, _
web As SPWeb, _
dateformat As SPDateFormat _
) As String
'Usage
Dim data As DateTime
Dim web As SPWeb
Dim dateformat As SPDateFormat
Dim returnValue As String
returnValue = SPFieldDateTime.GetFieldValueAsText(data, _
web, dateformat)
public static string GetFieldValueAsText(
DateTime data,
SPWeb web,
SPDateFormat dateformat
)
Parameter
data
Typ: System.DateTimeEine System.DateTime -Struktur, die den Wert für wie folgt für die Konvertierung in UTC-Format darstellt: JJJJ-MM-TTThh...
web
Typ: Microsoft.SharePoint.SPWebEin SPWeb
-Objekt, das die Website darstellt, die das Feld enthält.
dateformat
Typ: Microsoft.SharePoint.Utilities.SPDateFormatEin SPDateFormat -Wert, der das Datumsformat angibt.
Rückgabewert
Typ: System.String
Eine Zeichenfolge, die den Wert des Felds Daten enthält.
Hinweise
Die GetFieldValueAsText -Methode erfordert, dass Werte für Datum und Uhrzeit im UTC-Format, während die meisten SharePoint Foundation -Methoden zum Zurückgeben von Listendaten Rückgabe der Werte in Ortszeit sein. Daher müssen beim Ausführen von Abfragen für Listendaten, Sie konvertieren Zeitwerte, um die gewünschten Ergebnisse zu erzielen. Zum Zurückgeben von Elementen in UTC-Datum und Uhrzeit, verwenden Sie ein SPQuery -Objekt, und legen Sie die DatesInUtc -Eigenschaft auf true, wie im folgenden Beispiel gezeigt:
Dim query As New SPQuery()
query.DatesInUtc = true
Dim listItems As SPListItemCollection = list.GetItems(query)
SPQuery query = new SPQuery();
query.DatesInUtc = true;
SPListItemCollection listItems = list.GetItems(query);