Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Función DATE\$1DIFF en Amazon QLDB
<a name="ql-functions.date_diff"></a>

**importante**  
Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte [Migración de un registro de Amazon QLDB a Amazon Aurora](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) PostgreSQL.

En Amazon QLDB, use la función `DATE_DIFF` para devolver la diferencia entre las partes de fecha especificadas de dos marcas de tiempo determinadas.

## Sintaxis
<a name="ql-functions.date_diff.syntax"></a>

```
DATE_DIFF( datetimepart, timestamp1, timestamp2 )
```

## Argumentos
<a name="ql-functions.date_diff.arguments"></a>

*datetimepart*  
La parte de la fecha o la hora sobre la que opera la función. Este parámetro puede ser uno de los siguientes:  
+ `year`
+ `month`
+ `day`
+ `hour`
+ `minute`
+ `second`

*timestamp1*, *timestamp2*  
Los dos nombres de cambo o expresiones del tipo de datos `timestamp` que compara la función. Si *timestamp2* es posterior, el resultado es positivo*timestamp1*. Si *timestamp2* es anterior*timestamp1*, el resultado es negativo.  
El valor literal de una marca de tiempo de Ion se puede indicar con comillas invertidas (``...``). Para obtener más detalles sobre formatos y ejemplos de valores de marcas de tiempo, consulte [Marcas de tiempo](https://amzn.github.io/ion-docs/docs/spec.html#timestamp) en el documento de especificaciones de Amazon Ion.

## Tipo de retorno
<a name="ql-functions.date_diff.return-type"></a>

`int`

## Ejemplos
<a name="ql-functions.date_diff.examples"></a>

```
DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4
```

## Funciones relacionadas
<a name="ql-functions.date_diff.related"></a>
+ [DATE\$1ADD](ql-functions.date_add.md)
+ [EXTRACT](ql-functions.extract.md)
+ [TO\$1STRING](ql-functions.to_string.md)
+ [TO\$1TIMESTAMP](ql-functions.to_timestamp.md)
+ [UTCNOW](ql-functions.utcnow.md)