Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tailrocks/graphql-java-datetime

GraphQL ISO Date is a set of RFC 3339 compliant date/time scalar types to be used with graphql-java.
https://github.com/tailrocks/graphql-java-datetime

date datetime graphql graphql-java scalars time

Last synced: about 1 month ago
JSON representation

GraphQL ISO Date is a set of RFC 3339 compliant date/time scalar types to be used with graphql-java.

Host: GitHub
URL: https://github.com/tailrocks/graphql-java-datetime
Owner: tailrocks
License: apache-2.0
Created: 2017-07-09T09:10:22.000Z (over 7 years ago)
Default Branch: main
Last Pushed: 2023-11-29T15:12:50.000Z (about 1 year ago)
Last Synced: 2024-05-23T02:28:53.666Z (7 months ago)
Topics: date, datetime, graphql, graphql-java, scalars, time
Language: Java
Size: 1.08 MB
Stars: 145
Watchers: 7
Forks: 29
Open Issues: 13
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ccamel - tailrocks/graphql-java-datetime - GraphQL ISO Date is a set of RFC 3339 compliant date/time scalar types to be used with graphql-java. (Java)

README

# graphql-java-datetime

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/tailrocks/graphql-java-datetime/blob/master/LICENSE)
[![Latest Release](https://img.shields.io/maven-central/v/com.tailrocks.graphql/graphql-java-datetime)](https://maven-badges.herokuapp.com/maven-central/com.tailrocks.graphql/graphql-java-datetime/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/tailrocks/graphql-java-datetime/pulls)

GraphQL ISO Date is a set of RFC 3339 compliant date/time scalar types to be used with
[graphql-java](https://github.com/graphql-java/graphql-java).

# Summary

A set of ISO 33601, RFC 3339 compatible date time scalars for GraphQL Java implementation ([graphql-java](https://github.com/graphql-java/graphql-java)), as well as starters for
- GraphQL Java Kickstart [graphql-java-kickstart](https://www.graphql-java-kickstart.com/spring-boot/)
- Netflix DGS Framework [dgs-framework](https://netflix.github.io/dgs/)
- Spring GraphQL [spring-graphql](https://spring.io/projects/spring-graphql)

# Serialization

**java.util.Date**, **java.time.LocalDate**, **java.time.LocalDateTime**

| Format | JSON String |
|:-----------------------------|:-------------------------|
| yyyy-MM-dd'T'HH:MM:ss.SSS'Z' | 2017-07-09T13:14:45.947Z |
| yyyy-MM-dd'T'HH:MM:ss'Z' | 2017-07-09T11:54:42Z |
| yyyy-MM-dd'T'HH:MM:ss | 2017-07-09T11:54:42 |
| yyyy-MM-dd | 2017-07-09 |

**java.time.LocalTime**

| Format | JSON String |
|:-------------|:-------------|
| HH:MM:ss.SSS | 17:59:59.129 |
| HH:MM:ss | 17:59:59 |
| HH:MM | 17:59 |

**java.time.Duration**

| JSON String |
|:-----------------|
| PT1H30M |
| P1DT3H30M |
| P3Y6M4DT12H30M5S |

# Usage

## Spring Boot

This library supports the following popular graphql-java framework:
- GraphQL Java Kickstart [graphql-java-kickstart](https://www.graphql-java-kickstart.com/spring-boot/)
- Netflix DGS Framework [dgs-framework](https://netflix.github.io/dgs/)
- Spring GraphQL [spring-graphql](https://spring.io/projects/spring-graphql)

Add one of the following starters according to your project.

### Installation

#### Maven

Add the following to your `pom.xml`:

for **GraphQL Java Kickstart**:

```xml

com.tailrocks.graphql
graphql-datetime-kickstart-spring-boot-starter
6.0.0

```

for **Netflix DGS**:

```xml

com.tailrocks.graphql
graphql-datetime-dgs-starter
6.0.0

```

for **Spring GraphQL**:

```xml

com.tailrocks.graphql
graphql-datetime-spring-boot-starter
6.0.0

```

#### Gradle

Add the following to your `build.gradle`:

for **GraphQL Java Kickstart (Spring Boot)**:

```groovy
implementation("com.tailrocks.graphql:graphql-datetime-kickstart-spring-boot-starter:6.0.0")
```

for **DGS**:

```groovy
implementation("com.tailrocks.graphql:graphql-datetime-dgs-starter:6.0.0")
```

for **Spring GraphQL**:

```groovy
implementation("com.tailrocks.graphql:graphql-datetime-spring-boot-starter:6.0.0")
```

### Scalars

Add these scalars to your `.graphqls` schema file:

```graphql
# java.util.Date implementation
scalar Date

# java.time.LocalDate implementation
scalar LocalDate

# java.time.LocalDateTime implementation
scalar LocalDateTime

# java.time.LocalTime implementation
scalar LocalTime

# java.time.OffsetDateTime implementation
scalar OffsetDateTime

# java.time.YearMonth implementation
scalar YearMonth

# java.time.Duration implementation
scalar Duration
```

You can rename the scalar however you want by simply adding the following properties to your application.yaml:

```yaml
graphql:
datetime:
scalars:
date:
scalar-name: MyDate
local-date:
scalar-name: MyLocalDate
local-date-time:
scalar-name: MyLocalDateTime
local-time:
scalar-name: MyLocalTime
offset-date-time:
scalar-name: MyOffsetDateTime
year-month:
scalar-name: MyYearMonth
duration:
scalar-name: MyDuration
```

A custom format can be set for LocalDate and LocalDateTime only using the following properties in application.yaml

```yaml
graphql:
datetime:
scalars:
local-date:
format: MM/dd/yyyy
local-date-time:
format: yyyy-MM-dd'T'HH:mm:ss
```

You can enable automatic zone conversion by adding the following property to your application.yaml. This will
automatically convert between UTC and the default TimeZone for `LocalDateTime`:

```yaml
graphql:
datetime:
scalars:
zone-conversion-enabled: true
```

If using OffsetDateTime in order to present the offset and disable the automatic convertion to UTC from Jackson you
should set to your application.yml the following:

```yaml
spring:
jackson:
deserialization:
adjust-dates-to-context-time-zone: false
```

### Sample

Now you can use these scalars in your application. Here are graphql-datetime spring boot sample applications:

- **webmvc:**
- dgs: [sample-graphql-datetime-dgs-webmvc](samples/dgs-webmvc)
- kickstart: [sample-graphql-datetime-kickstart-webmvc](samples/kickstart-webmvc)
- spring-graphql: [sample-graphql-datetime-spring-boot-webmvc](samples/spring-boot-webmvc)
- **webflux:**
- kickstart: [sample-graphql-datetime-kickstart-webflux](samples/kickstart-webflux)

## Bugs

To report any bug, please use the project [Issues](https://github.com/tailrocks/graphql-java-datetime/issues/new) section
on GitHub.

## Contributing

Please contribute using [Github Flow](https://guides.github.com/introduction/flow/). Create a branch, add commits,
and [open a pull request](https://github.com/tailrocks/graphql-java-datetime/compare/).

## License

This project is licensed under the Apache License, Version 2.0 - see the [LICENSE](LICENSE) file for details.