SPFieldDateTime.GetFieldValueAsText method (DateTime, SPWeb, SPDateFormat)
Retorna o valor de dados do campo especificado, expressado em formato Tempo Universal Coordenado (UTC), como uma seqüência de caracteres com base na data especificada e valor de tempo, site da Web pai e o formato de data SharePoint Foundation .
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
Public Shared Function GetFieldValueAsText ( _
data As DateTime, _
web As SPWeb, _
dateformat As SPDateFormat _
) As String
'Uso
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
)
Parâmetros
data
Type: System.DateTimeUma estrutura System.DateTime que representa o valor de dados para converter no formato UTC, da seguinte maneira: YYYY-MM-DDTHH:MM:SSZ...
web
Type: Microsoft.SharePoint.SPWebUm SPWeb
objeto que representa o site que contém o campo.
dateformat
Type: Microsoft.SharePoint.Utilities.SPDateFormatUm valor de SPDateFormat que especifica o formato de data.
Valor retornado
Type: System.String
Uma seqüência de caracteres que contém o valor de dados de campo.
Comentários
O método GetFieldValueAsText requer que os valores de data e hora estejam no formato UTC, enquanto a maioria dos métodos de SharePoint Foundation para retornar dados da lista de retorno de valores no horário local. Conseqüentemente, ao executar consultas para dados de lista, você precisa converter os valores de tempo para chegar aos resultados esperados. Para retornar os itens de data UTC e a hora, use um objeto SPQuery e defina a propriedade de DatesInUtc para true, conforme mostrado no exemplo a seguir:
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);