Excel.DatetimeFormatInfo class

Определяет приемлемый с точки зрения культуры формат отображения чисел. Это основано на текущих параметрах системной культуры.

Extends

Комментарии

Набор API: ExcelApi 1.12

Используется

Свойства

context

Контекст запроса, связанный с объектом. Это соединяет процесс надстройки с процессом основного приложения Office.

dateSeparator

Получает строку, используемую в качестве разделителя даты. Это зависит от текущих системных настроек.

longDatePattern

Получает строку формата для длинного значения даты. Это зависит от текущих системных настроек.

longTimePattern

Получает строку формата для значения long time. Это зависит от текущих системных настроек.

shortDatePattern

Получает строку формата для короткого значения даты. Это зависит от текущих системных настроек.

shortDateTimePattern

Получает строку формата для краткого значения даты и времени. Это зависит от текущих системных настроек.

timeSeparator

Получает строку, используемую в качестве разделителя времени. Это зависит от текущих системных настроек.

Методы

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringify, в свою очередь, вызывает toJSON метод переданного ему объекта.) В то время как исходный Excel.DatetimeFormatInfo объект является объектом API, toJSON метод возвращает простой объект JavaScript (типизированный как Excel.Interfaces.DatetimeFormatInfoData), который содержит неглубокие копии любых загруженных дочерних свойств исходного объекта.

Сведения о свойстве

context

Контекст запроса, связанный с объектом. Это соединяет процесс надстройки с процессом основного приложения Office.

context: RequestContext;

Значение свойства

dateSeparator

Получает строку, используемую в качестве разделителя даты. Это зависит от текущих системных настроек.

readonly dateSeparator: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.12

longDatePattern

Получает строку формата для длинного значения даты. Это зависит от текущих системных настроек.

readonly longDatePattern: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.12

longTimePattern

Получает строку формата для значения long time. Это зависит от текущих системных настроек.

readonly longTimePattern: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.12

shortDatePattern

Получает строку формата для короткого значения даты. Это зависит от текущих системных настроек.

readonly shortDatePattern: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.12

shortDateTimePattern

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

Получает строку формата для краткого значения даты и времени. Это зависит от текущих системных настроек.

readonly shortDateTimePattern: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ)

timeSeparator

Получает строку, используемую в качестве разделителя времени. Это зависит от текущих системных настроек.

readonly timeSeparator: string;

Значение свойства

string

Комментарии

Набор API: ExcelApi 1.12

Сведения о методе

load(options)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(options?: Excel.Interfaces.DatetimeFormatInfoLoadOptions): Excel.DatetimeFormatInfo;

Параметры

options
Excel.Interfaces.DatetimeFormatInfoLoadOptions

Предоставляет параметры для загружаемых свойств объекта.

Возвращаемое значение

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNames?: string | string[]): Excel.DatetimeFormatInfo;

Параметры

propertyNames

string | string[]

Строка с разделителями-запятыми или массив строк, которые определяют свойства для загрузки.

Возвращаемое значение

load(propertyNamesAndPaths)

Добавляет в очередь команду для загрузки указанных свойств объекта. Перед чтением свойств требуется вызвать метод context.sync().

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.DatetimeFormatInfo;

Параметры

propertyNamesAndPaths

{ select?: string; expand?: string; }

propertyNamesAndPaths.select — это строка с разделителями-запятыми, указывающая загружаемые свойства, и строка propertyNamesAndPaths.expand через запятую, указывающая свойства навигации для загрузки.

Возвращаемое значение

toJSON()

Переопределяет метод JavaScript toJSON() , чтобы обеспечить более полезные выходные данные при передаче объекта API в JSON.stringify(). (JSON.stringify, в свою очередь, вызывает toJSON метод переданного ему объекта.) В то время как исходный Excel.DatetimeFormatInfo объект является объектом API, toJSON метод возвращает простой объект JavaScript (типизированный как Excel.Interfaces.DatetimeFormatInfoData), который содержит неглубокие копии любых загруженных дочерних свойств исходного объекта.

toJSON(): Excel.Interfaces.DatetimeFormatInfoData;

Возвращаемое значение