Methods starting "Parse" are for parsing the Discovery format to a .NET type.
Methods starting "Format" are for formatting .NET types to Discovery formats.
This class does not provide methods forDateTimeandobjectconversions; properties with a type of DateTime or object are marked as obsolete in the generated code,
and have legacy behavior which cannot reasonably be changed for backward compatibility reasons.
Methods
FormatDateTimeOffsetToDateTime(DateTimeOffset?)
public static string FormatDateTimeOffsetToDateTime(DateTimeOffset? value)
Formats aDateTimevalue appropriately for a Discovery "date-time" value.
This does not automatically convert the given value to UTC; some services require values
to be presented in UTC, in which case user code should ensure that only UTC values are
specified.
public static DateTimeOffset? ParseDateTimeToDateTimeOffset(string value)
Parses a Discovery "date-time" format value toDateTimeOffset.
The value must start in the format "yyyy-MM-ddTHH:mm:ss", with optional milliseconds,
microseconds and nanoseconds. A UTC offset may be provided with up to second precision
(e.g. +01, -02:30, +03:45:12), or "Z" for UTC. If nanosecond precision is provided,
the value is truncated to .NET "tick" precision (100ns). If the UTC offset has a non-zero
seconds component, a value is returned which preserves the instant in time, but truncates
the UTC offset to the minute.
public static DateTimeOffset? ParseGoogleDateTimeToDateTimeOffset(string value)
Parses a Discovery "google-datetime" format value toDateTimeOffset.
The value must start in the format "yyyy-MM-ddTHH:mm:ss", with optional milliseconds,
microseconds and nanoseconds, and a trailing 'Z' to indicate UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eThis webpage details the \u003ccode\u003eDiscoveryFormat\u003c/code\u003e class within the \u003ccode\u003eGoogle.Apis.Util\u003c/code\u003e namespace, providing utility methods for converting data to and from Discovery API formats.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDiscoveryFormat\u003c/code\u003e class offers methods to parse Discovery format strings into .NET \u003ccode\u003eDateTimeOffset\u003c/code\u003e types and format .NET \u003ccode\u003eDateTimeOffset\u003c/code\u003e types into Discovery formats.\u003c/p\u003e\n"],["\u003cp\u003eMethods prefixed with "Parse" handle conversions from Discovery formats to .NET types, while those prefixed with "Format" convert .NET types to Discovery formats.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eFormatDateTimeOffsetToDateTime\u003c/code\u003e method formats \u003ccode\u003eDateTimeOffset\u003c/code\u003e values for a Discovery "date-time," and \u003ccode\u003eFormatDateTimeOffsetToGoogleDateTime\u003c/code\u003e for a Discovery "google-datetime" format, with the latter automatically converting to UTC.\u003c/p\u003e\n"],["\u003cp\u003eThis class doesn't handle conversions for \u003ccode\u003eDateTime\u003c/code\u003e and \u003ccode\u003eobject\u003c/code\u003e types because of legacy behavior; therefore, properties of these types in generated code are marked as obsolete.\u003c/p\u003e\n"]]],[],null,["# Class DiscoveryFormat (1.69.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.69.0 (latest)](/dotnet/docs/reference/Google.Apis/latest/Google.Apis.Util.DiscoveryFormat)\n- [1.68.0](/dotnet/docs/reference/Google.Apis/1.68.0/Google.Apis.Util.DiscoveryFormat)\n- [1.60.0](/dotnet/docs/reference/Google.Apis/1.60.0/Google.Apis.Util.DiscoveryFormat)\n- [1.59.0](/dotnet/docs/reference/Google.Apis/1.59.0/Google.Apis.Util.DiscoveryFormat)\n- [1.55.0](/dotnet/docs/reference/Google.Apis/1.55.0/Google.Apis.Util.DiscoveryFormat)\n- [1.50.0](/dotnet/docs/reference/Google.Apis/1.50.0/Google.Apis.Util.DiscoveryFormat) \n\n public static class DiscoveryFormat\n\nUtility methods to convert to/from Discovery API formats.\nSee \u003chttps://developers.google.com/discovery/v1/type-format\u003e \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e DiscoveryFormat \n\nInherited Members\n-----------------\n\n[object.Equals(object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object)) \n[object.Equals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.equals#system-object-equals(system-object-system-object)) \n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.MemberwiseClone()](https://learn.microsoft.com/dotnet/api/system.object.memberwiseclone) \n[object.ReferenceEquals(object, object)](https://learn.microsoft.com/dotnet/api/system.object.referenceequals) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Apis.Util](/dotnet/docs/reference/Google.Apis/latest/Google.Apis.Util)\n\nAssembly\n--------\n\nGoogle.Apis.Core.dll\n\nRemarks\n-------\n\nMethods starting \"Parse\" are for parsing the Discovery format to a .NET type.\nMethods starting \"Format\" are for formatting .NET types to Discovery formats.\nThis class does not provide methods for [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime) and [object](https://learn.microsoft.com/dotnet/api/system.object)\nconversions; properties with a type of DateTime or object are marked as obsolete in the generated code,\nand have legacy behavior which cannot reasonably be changed for backward compatibility reasons.\n\nMethods\n-------\n\n### FormatDateTimeOffsetToDateTime(DateTimeOffset?)\n\n public static string FormatDateTimeOffsetToDateTime(DateTimeOffset? value)\n\nFormats a [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime) value appropriately for a Discovery \"date-time\" value.\nThis does not automatically convert the given value to UTC; some services require values\nto be presented in UTC, in which case user code should ensure that only UTC values are\nspecified.\n\n### FormatDateTimeOffsetToGoogleDateTime(DateTimeOffset?)\n\n public static string FormatDateTimeOffsetToGoogleDateTime(DateTimeOffset? value)\n\nFormats a [DateTime](https://learn.microsoft.com/dotnet/api/system.datetime) value appropriately for a Discovery \"google-datetime\" value.\nThis automatically converts the given value to UTC before formatting.\n\n### ParseDateTimeToDateTimeOffset(string)\n\n public static DateTimeOffset? ParseDateTimeToDateTimeOffset(string value)\n\nParses a Discovery \"date-time\" format value to [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset).\nThe value must start in the format \"yyyy-MM-ddTHH:mm:ss\", with optional milliseconds,\nmicroseconds and nanoseconds. A UTC offset may be provided with up to second precision\n(e.g. +01, -02:30, +03:45:12), or \"Z\" for UTC. If nanosecond precision is provided,\nthe value is truncated to .NET \"tick\" precision (100ns). If the UTC offset has a non-zero\nseconds component, a value is returned which preserves the instant in time, but truncates\nthe UTC offset to the minute.\n\n### ParseGoogleDateTimeToDateTimeOffset(string)\n\n public static DateTimeOffset? ParseGoogleDateTimeToDateTimeOffset(string value)\n\nParses a Discovery \"google-datetime\" format value to [DateTimeOffset](https://learn.microsoft.com/dotnet/api/system.datetimeoffset).\nThe value must start in the format \"yyyy-MM-ddTHH:mm:ss\", with optional milliseconds,\nmicroseconds and nanoseconds, and a trailing 'Z' to indicate UTC."]]
