sc_date_conv({Campo_Data}, "Formato_Entrada", "Formato_Saída")

Um trabalho relativamente complexo na programação é a manipulação de datas. Para minimizar este problema o ScriptCase disponibiliza a função para conversão de datas sc_date_conv.

 

Confira abaixo a lista de parâmetros para esta macro e os valores aceitos.

Parâmetro
Valores Descrição


field_name

Exemplo de como deve ser informado o parâmetro: {Nome_Campo_Data}


Esta parâmetro deve receber o nome do campo data que terá o valor manipulado




formato_Entrada 

A string deve ter o mesmo formato utilizado no banco de dados.

Exemplo de como deve ser informada a string da data na macro: "aaaa-mm-dd"

Opções aceitas:

  • String de datas - Por exemplo "aaaa-mm-dd"
  • db_Format - Recupera o formato da data do banco de dados.

Recebe a string com o formato atual da data, salvo no banco de dados.

Caso o formato informado esteva diferente do utilizado no banco de dados, a macro não irá funcionar da forma esperada.






formato_Saída 

A String deve ter o formato que a data será exibida.

Exemplo de como deve ser informada a string da data na macro: "dd/mm/aaaa"

Opções aceitas:

  • String de datas - Por exemplo "dd-mm-aaaa"
  • sc_format_region - Valor formatado de acordo com a configuração regional
  • db_Format - Converte a data para o valor nativo do banco de dados

Recebe a string com o formado de exibição da data desejado.

Caso queira utilizar o formato de acordo com a configuração regionar, deve ser informado o valo sc_format_region neste parâmetro



Para mais informações sobre as strings das dadas consulte o Manual do PHP

 

Ex. 1: Convertendo a data do formato "dd/mm/aaaa" para o formato "aaaammdd"

{campo_data} = sc_date_conv({campo_data},"dd/mm/aaaa","aaaammdd");

Ex. 2: Convertendo a data do formato nativo do banco de dados para o formato "dd/mm/aaaa"

{campo_data} = sc_date_conv({campo_data},"db_format","dd/mm/aaaa");

Ex. 3: Convertendo a data do formato "dd/mm/aaaa" para o formato nativo do Banco de dados

{campo_data} = sc_date_conv({campo_data},"dd/mm/aaaa","db_format");

Ex. 4: Convertendo a data do formato formato nativo do Banco de dados para o formato da configuração regional

{campo_data} = sc_date_conv({campo_data},"db_format","sc_format_region");

Ex. 5: Convertendo a data do formato "aaaa-mm-dd" para o formato da configuração regional

{campo_data} = sc_date_conv({campo_data},"aaaa-mm-dd","sc_format_region");