 |
API Sirene - Documentation des services |
 |
Requête sur les variables de type date
Il est possible de faire des recherches sur les variables de type date, y compris les dates de début et de fin de période.
ws/siren
ws/siret
dateCreationUniteLegale
dateCreationEtablissement
dateDernierTraitementUniteLegale
dateDernierTraitementEtablissement
dateDebut
dateDebut
dateFin
dateFin
Les variables dates requêtables sont :
La syntaxe est la suivante :
variabledate:AAAA-MM-JJ recherche sur le jour correspondant
variabledate:AAAA-MM recherche sur le mois correspondant
variabledate:AAAA recherche sur l'année correspondante
Pour les variables dateDernierTraitementUniteLegale et dateDernierTraitementEtablissement, la précision peut aller jusu'à la milliseconde :
variabledate:AAAA-MM-JJTHH
variabledate:AAAA-MM-JJTHH:MM
variabledate:AAAA-MM-JJTHH:MM:SS
variabledate:AAAA-MM-JJTHH:MM:SS.MMM
L'utilisation des intervalles est également possible (pour voir la voir syntaxe complète : Requête sur une plage de valeurs) en combinant les possibilités (jour, mois, année et heure, minute, seconde pour les deux variables précitées)
exemple :
variabledate:[2001 TO 2004-05] cherchera du 01/01/2001 inclus au 31/05/2004 inclus
variabledate:[2017 TO *] cherchera à partir du 01/01/2017
Les variables dateDebut et dateFin sont considérées comme des variables historisées, la syntaxe est donc la suivante :
periode(dateDebut:xxxx) ou periode(dateFin:xxxx)
La syntaxe valable dans la V3.2 est toujours acceptée :
variabledate:"AAAA-MM-JJT00:00:00Z"
variabledate:[ʺAAAA-MM-JJT00:00:00Zʺ TO ʺAAAA-MM-JJT00:00:00Zʺ]
etc.
Exemples
Recherche de toutes les UL dont la date de création est au 01/01/2014 : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=dateCreationUniteLegale:2014-01-01Recherche de toutes les UL dont l’année de création est entre 1980 et 2003 : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=dateCreationUniteLegale:[1980 TO 2003]
Recherche de tous les établissements mis à jour au mois de février 2018 et non mis à jour depuis : https://api.insee.fr/entreprises/sirene/V3.11/siret?q=dateDernierTraitementEtablissement:2018-02
Recherche de toutes les UL qui ont eu un changement de dénomination l'année 2017 : https://api.insee.fr/entreprises/sirene/V3.11/siren?q=periode(changementDenominationUniteLegale:true AND dateDebut:2017)
Commentaires
Les requêtes sur variables de dates sont également accessibles par une console regroupant les principales fonctions. Pour en savoir plus