Format de date personnalisé Java | Recherche de plage de dates avec GroupDocs

La recherche de documents par date est une exigence fréquente—que vous construisiez un système d’archivage, un outil de reporting financier ou un portail de gestion de contenu. Dans ce tutoriel, vous apprendrez les techniques de custom date format java avec GroupDocs.Search, couvrant les requêtes de plage de dates, les définitions de modèles personnalisés et des conseils pour optimiser les performances de recherche. À la fin, vous pourrez permettre aux utilisateurs de récupérer les enregistrements qui se situent dans n’importe quel intervalle de dates, quel que soit le format utilisé.

Réponses rapides

  • Quelle est la classe principale pour l’indexation ? Index du package com.groupdocs.search.
  • Comment définir un modèle de date personnalisé ? Utilisez DateFormat avec des objets DateFormatElement et un séparateur.
  • Puis-je rechercher avec une requête texte ? Oui, la syntaxe daterange(start ~~ end) fonctionne directement dans la chaîne de requête.
  • Quelles coordonnées Maven sont requises ? com.groupdocs:groupdocs-search:25.4 (ou plus récent).
  • Ai-je besoin d’une licence pour le développement ? Un essai gratuit ou une licence temporaire suffit pour les tests ; une licence commerciale est requise pour la production.

Qu’est-ce que le custom date format java ?

Un custom date format java indique à GroupDocs.Search comment interpréter les chaînes de date qui ne suivent pas le modèle ISO par défaut (YYYY‑MM‑DD). En définissant votre propre modèle—tel que MM/dd/yyyy ou dd‑MM‑yyyy—vous permettez au moteur de reconnaître les dates intégrées dans les documents qui utilisent des formats régionaux ou hérités.

Pourquoi utiliser GroupDocs.Search pour les requêtes de plage de dates ?

  • Vitesse : L’indexation intégrée rend les recherches O(log n).
  • Flexibilité : Prend en charge la création de requêtes basées sur du texte et sur des objets.
  • Support multi‑format : Gère les PDF, Word, Excel, texte brut, et plus sans code supplémentaire.

Comment rechercher des documents par date avec GroupDocs.Search

Vous trouverez ci‑dessous un guide étape par étape qui vous montre comment configurer la bibliothèque, indexer les fichiers et exécuter des recherches de plage de dates simples et avancées.

Prerequisites

  • Java 8 ou version supérieure installé.
  • Maven pour la gestion des dépendances.
  • Accès à une licence GroupDocs.Search (essai ou temporaire fonctionne pour le développement).

Setting Up GroupDocs.Search for Java

Installation Using Maven

Ajoutez le dépôt et la dépendance à votre pom.xml :

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/search/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-search</artifactId>
      <version>25.4</version>
   </dependency>
</dependencies>

Direct Download

Alternativement, vous pouvez télécharger la dernière version directement depuis GroupDocs.Search for Java releases.

Basic Initialization and Setup

Créez une instance Index et ajoutez vos documents :

import com.groupdocs.search.*;

String indexFolder = "YOUR_INDEX_DIRECTORY";
String documentsFolder = "YOUR_DOCUMENTS_DIRECTORY";

// Creating an index in the specified folder
Index index = new Index(indexFolder);

// Indexing documents from the specified folder
index.add(documentsFolder);

Fonctionnalité 1 : Création de requêtes de recherche de plage de dates

Utilisation de la requête sous forme texte

La façon la plus simple est d’intégrer la plage de dates directement dans la chaîne de requête :

import com.groupdocs.search.*;
import com.groupdocs.search.results.*;

// Define directories (as previously shown)

Index index = new Index(indexFolder);
index.add(documentsFolder);

// Create a text-based query for the specified date range
String query1 = "daterange(2017-01-01 ~~ 2019-12-31)";
SearchResult result1 = index.search(query1);

Explication : La syntaxe daterange attend des dates au format YYYY‑MM‑DD. Elle renvoie tous les documents dont les dates indexées se situent dans l’intervalle.

Utilisation d’un objet Query

Pour un contrôle programmatique et un parsing personnalisé, construisez un objet SearchQuery :

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

// Define directories (as previously shown)

Index index = new Index(indexFolder);
index.add(documentsFolder);

// Create a date range query using the Query API
SearchQuery query2 = SearchQuery.createDateRangeQuery(Utils.createDate(2017, 1, 1), Utils.createDate(2019, 12, 31));
SearchResult result2 = index.search(query2);

Explication : createDateRangeQuery vous permet de fournir des objets java.util.Date, vous offrant une flexibilité totale sur les fuseaux horaires et la gestion spécifique aux paramètres régionaux.

Fonctionnalité 2 : Spécification des modèles custom date format java

Définition des formats de date personnalisés

Définissez un DateFormat qui correspond à la représentation de date de votre document :

import com.groupdocs.search.*;
import com.groupdocs.search.options.*;
import com.groupdocs.search.results.*;

// Define directories (as previously shown)

Index index = new Index(indexFolder);
index.add(documentsFolder);

// Configure search options with custom date formats
SearchOptions options = new SearchOptions();
options.getDateFormats().clear(); // Remove default formats

DateFormatElement[] elements = new DateFormatElement[]{
    DateFormatElement.getMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getDayOfMonthTwoDigits(),
    DateFormatElement.getDateSeparator(),
    DateFormatElement.getYearFourDigits()
};

// Create a custom date format pattern 'MM/dd/yyyy'
DateFormat dateFormat = new DateFormat(elements, "/");
options.getDateFormats().addItem(dateFormat);

String query = "daterange(01/01/2017 ~~ 12/31/2019)";
SearchResult result = index.search(query, options);

Explication : En supprimant les formats par défaut et en ajoutant un DateFormat qui utilise / comme séparateur, le moteur comprend désormais les dates écrites sous la forme MM/dd/yyyy. Ceci est essentiel pour rechercher des documents par date dans les régions qui préfèrent la notation mois‑premier.

Conseils pour optimiser les performances de recherche

  • Indexer de façon incrémentielle : Ajoutez de nouveaux fichiers à l’index existant au lieu de le reconstruire à partir de zéro.
  • Élaguer les données obsolètes : Supprimez périodiquement les documents qui ne sont plus nécessaires.
  • Ajuster les paramètres de mémoire : Augmentez le tas JVM (-Xmx) lorsque vous travaillez avec de grands index.

Common Issues and Solutions

  • Erreurs d’analyse de date : Vérifiez que les chaînes de date du document correspondent exactement au modèle personnalisé que vous avez défini.
  • Résultats manquants : Assurez-vous que les champs indexés contiennent des métadonnées de date ; sinon, le moteur ne peut pas faire correspondre les requêtes de date.
  • Exceptions d’accès à l’index : Confirmez que le chemin indexFolder est accessible en écriture et n’est pas verrouillé par un autre processus.

Applications pratiques

  1. Systèmes d’archivage – Récupérer les enregistrements d’une période historique spécifique.
  2. Gestion de contenu – Prendre en charge les formats de date régionaux comme dd/MM/yyyy pour les publics européens.
  3. Logiciel financier – Filtrer les transactions par trimestre fiscal ou année rapidement.

Conclusion

Vous disposez maintenant d’une boîte à outils complète custom date format java pour créer des recherches puissantes de plages de dates avec GroupDocs.Search. Implémentez ces modèles, affinez les performances, et votre application fournira des résultats rapides et précis pour toute requête temporelle.

Frequently Asked Questions

Q : Quelle est la différence entre les requêtes de date sous forme texte et basées sur des objets ?
R : La forme texte est rapide et facile mais limitée au format ISO par défaut ; les requêtes basées sur des objets vous permettent de fournir des objets Date et des formats personnalisés pour une plus grande flexibilité.

Q : Puis-je rechercher plusieurs plages de dates dans une seule requête ?
R : Oui, combinez des clauses daterange avec des opérateurs logiques comme AND ou OR pour construire des requêtes complexes.

Q : Les formats de date personnalisés ralentiront-ils la recherche ?
R : Il y a un léger surcoût lié au parsing supplémentaire, mais l’impact est négligeable pour les charges de travail typiques et est compensé par les gains de précision.

Q : GroupDocs.Search est‑il adapté aux déploiements à grande échelle ?
R : Absolument. Avec des stratégies d’indexation appropriées et un réglage JVM, il peut évoluer jusqu’à des millions de documents.

Q : Où puis‑je trouver plus d’exemples Java ?
R : Explorez le dépôt GitHub GroupDocs pour des exemples supplémentaires et des implémentations de cas d’utilisation.

Ressources

  • Dernière mise à jour : 2025-12-18
  • Testé avec : GroupDocs.Search Java 25.4
  • Auteur : GroupDocs