Personalizar o carimbo de data e hora

Personalize carimbos de data e hora usando o Livefyre.js.

Os aplicativos Livefyre fornecem o parâmetro de opção, datetimeFormat, para especificar o formato de data, conforme descrito abaixo.

Terminologia

  • Os carimbos de data e hora absolutos são definidos como horários exatos e específicos (por exemplo, 1 de janeiro de 2012, 12:00 pm)
  • Os carimbos de data e hora relativos são definidos como horários gerais e menos precisos (por exemplo, 25 segundos atrás, 14 minutos atrás, 1 dia atrás, 1 ano atrás etc.)

Formatação

O parâmetro datetimeFormat tem o seguinte comportamento padrão quando nenhum argumento é fornecido:

  • Formato de data e hora de: MMMM d yyyy (para 8 de janeiro de 2012)
  • 20160 Minutos (14 dias) até o tempo absoluto (14 dias até que os carimbos de data e hora relativos se tornem carimbos de data e hora absolutos)

O parâmetro datetimeFormat aceita três tipos de argumento possíveis: datetime, format e string.

// Example 1 (Datetime format string)
var convConfig = {
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo",
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc",
   "siteId":"12345",
   "articleId":5,
   "el":"comments1",
   "datetimeFormat": 'MMM d y Ka'
};
var conv = fyre.conv.load(networkConfig, [convConfig]);

Um objeto que especifica a propriedade fullFormat e/ou minutesuntilAbsoluteTime. Um minutesuntilAbsoluteTime com um valor de -1 tornará o tempo absoluto imediato.

// Example 2 (Object)
var convConfig = {
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo",
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc",
   "siteId":"12345",
   "articleId":5,
   "el":"comments1",
   "datetimeFormat": {
      minutesUntilAbsoluteTime: 10,
      absoluteFormat: 'MMM d y Ka'
   }
};
var conv = fyre.conv.load(networkConfig, [convConfig]);

Uma função que utiliza como argumento um objeto Date e retorna uma string de data e hora a ser exibida

// Example 3 (Function accepting a Date object, returning a datetime string to display)
var convConfig = {
   "collectionMeta":"eyJ0eXAiOiJqd3QiLCJhbGciOiJIUzI1NiJ9.eyJ0aXRsZSI6InBvc3QgMiIsInVybCI6Imh0dHA6XC9cL29yYW5nZXNhcmVncmVhdC5jb21cL3VzZWExcDcwXzEyXC8_cD01IiwidGFncyI6IiIsImNoZWNrc3VtIjoiYjBiYzRkMmVmY2UyZWZkYzZkYTE4NmQ2ZGZhNmVkYzAiLCJhcnRpY2xlSWQiOjV9.XZJTJgwpiFZCQ6dv8vvl91sMbFSJndzZPTHhmtOaImo",
   "checksum":"b0bc4d2efce2efdc6da186d6dfa6edc",
   "siteId":"12345",
   "articleId":5,
   "el":"comments1",
   "datetimeFormat": function(theDateInput) {
      return +theDateInput;
   }
};
var conv = fyre.conv.load(networkConfig, [convConfig]);

Designação do Símbolo

Funções de formatação de data e hora que seguem a especificação de padrão, conforme definido em JDK, ICU e CLDR, com pequena modificação para uso típico em JS. Para obter mais informações, consulte a Documentação da Biblioteca de Fechamento do Google.

  Symbol Meaning Presentation        Example
  ------   -------                 ------------        -------
  G        era designator          (Text)              AD
  y#       year                    (Number)            1996
  Y* year (week of year)     (Number)            1997
  u* extended year           (Number)            4601
  M        month in year           (Text & Number)     July & 07
  d        day in month            (Number)            10
  h        hour in am/pm (1~12)    (Number)            12
  H        hour in day (0~23)      (Number)            0
  m        minute in hour          (Number)            30
  s        second in minute        (Number)            55
  S        fractional second       (Number)            978
  E        day of week             (Text)              Tuesday
  e* day of week (local 1~7) (Number)            2
  D* day in year             (Number)            189
  F* day of week in month    (Number)            2 (2nd Wed in July)
  w* week in year            (Number)            27
  W* week in month           (Number)            2
  a        am/pm marker            (Text)              PM
  k        hour in day (1~24)      (Number)            24
  K        hour in am/pm (0~11)    (Number)            0
  z        time zone               (Text)              Pacific Standard Time
  Z        time zone (RFC 822)     (Number)            -0800
  v        time zone (generic)     (Text)              Pacific Time
  g* Julian day              (Number)            2451334
  A* milliseconds in day     (Number)            69540000
  '        escape for text         (Delimiter)         'Date='
  ''       single quote            (Literal)           'o''clock'

Os itens marcados com "*" ainda não são suportados.

Os itens marcados com "#" funcionam de forma diferente do Java.

A contagem de letras de padrão determina o formato.

  • Texto: 4 ou mais, use o formulário completo. Menos de 4, use o formulário curto ou abreviado, se existir. (Por exemplo: "EEEE" produz "Segunda-feira", "EEE" produz "Mon".)
  • Número: o número mínimo de dígitos. Números mais curtos são zero preenchidos para esse valor (por exemplo: Se "m" produzir "6", "mm" produzirá "06".) O ano é manipulado especialmente; ou seja, se a contagem de "y" for 2, o Ano será truncado para 2 dígitos. (Por exemplo: se "aaaa" produzir "1997", "yy" produzirá "97".) Ao contrário de outros campos, segundos fracionais são preenchidos à direita com zero.
  • Texto e número: 3 ou superior, use texto. Menos de 3, use número. (Por exemplo: "M" produz "1", "MM" produz "01", "MMM" produz "Jan" e "MMMM" produz "Janeiro".)

Quaisquer caracteres no padrão que não estejam nos intervalos de [‘a’."z"] e ["A"."Z’] será tratado como texto entre aspas. Por exemplo, caracteres como ‘:’, ‘.’, ‘, ‘#’ e ‘@’ aparecerão no texto de tempo resultante mesmo que não sejam aceitos entre aspas simples.

Nesta página