https://github.com/alipsa/swing-yearmonth-picker
A year-month date picker component for java swing
https://github.com/alipsa/swing-yearmonth-picker
Last synced: 7 months ago
JSON representation
A year-month date picker component for java swing
- Host: GitHub
- URL: https://github.com/alipsa/swing-yearmonth-picker
- Owner: Alipsa
- License: mit
- Created: 2023-10-25T13:45:51.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-21T08:20:35.000Z (over 1 year ago)
- Last Synced: 2025-02-21T09:27:58.133Z (over 1 year ago)
- Language: Java
- Size: 112 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# Swing Yearmonth picker
[](https://maven-badges.herokuapp.com/maven-central/se.alipsa/swing-yearmonth-picker)
[](https://javadoc.io/doc/se.alipsa/swing-yearmonth-picker)
A year-month date picker component for java swing. Requires java 11 or higher (tested with jdk 11 and 17)
There are two versions:
1. YearMonthPickerCombo - a combobox that return a YearMonth.
2. YearMonthPicker - A custom control that resembles DatePicker where the user can click a calendar and then pick the
desired year month.
Both works similar to a combo box i.e. you do getValue() to get the value and
setOnAction() to capture a value change e.g.
```java
import se.alipsa.symp.YearMonthPicker;
class Example {
public static void main(String[] args) {
JFrame frame = new JFrame("Year month combo");
JPanel panel = new JPanel();
frame.add(panel);
YearMonthPicker ymp = new YearMonthPicker();
ymp.addListener(e -> System.out.println(ymp.getValue()));
panel.add(new JLabel("Default Combo: "));
panel.add(ymp);
frame.pack();
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setVisible(true);
}
}
```
There are no external dependencies, and the jar file is about 40kb so nice and small. You can download the jar file from
the release section or add the following to your maven file:
```xml
se.alipsa
swing-yearmonth-picker
1.0.0
```
...or the equivalent to you favorite build tool.
The module name for this library is `se.alipsa.symp`
## se.alipsa.symp.YearMonthPickerCombo
There are 5 constructors:
__YearMonthPickerCombo()__
This gives you YearMonths 3 year back and 3 years into the future from now.
__YearMonthPickerCombo(YearMonth initial)__
This gives you YearMonths 3 year back and 3 years into the future from initial.
__YearMonthPickerCombo(YearMonth from, YearMonth to, YearMonth initial)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected.
__YearMonthPickerCombo(YearMonth from, YearMonth to, YearMonth initial, Locale locale)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected displayed in the locale specified formatted as "yyyy-MM".
__YearMonthPickerCombo(YearMonth from, YearMonth to, YearMonth initial, Locale locale, String format)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected, displayed in the locale specified in the format specified.
## se.alipsa.symp.YearMonthPicker
There are 5 constructors:
__YearMonthPicker()__ This gives you YearMonths 3 year back and 3 years into the future from now in
the system default locale.
__YearMonthPicker(YearMonth initial)__
This gives you YearMonths 3 year back and 3 years into the future from initial in
the system default locale.
__YearMonthPicker(YearMonth initial, Locale locale)__
This gives you YearMonths 3 year back and 3 years into the future from initial in
the specified locale. Month names are in full (long) format.
__YearMonthPicker(YearMonth from, YearMonth to, YearMonth initial)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected in the default locale.
The display value (when a year month is chosen) will be displayed in the
format "yyyy-MM".
__YearMonthPicker(YearMonth from, YearMonth to, YearMonth initial, String monthNameFormat)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected in the default locale. MonthNameFormat is how the
month names will be displayed in the popup. Set it to "MMM" for the letter short style
or include the year with "yyyy-MMM" or whatever.
The display value (when a year month is chosen) will be displayed in the
format "yyyy-MM".
__YearMonthPicker(YearMonth from, YearMonth to, YearMonth initial, Locale locale, String monthNameFormat)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected in the locale specified. MonthNameFormat is how the
month names will be displayed in the popup. Default is "MMMM" (long format), set to "MMM" for the letter short style
or include the year with "yyyy-MMM" or whatever. The display value (when a year month is chosen) will be displayed in the
format "yyyy-MM".
__YearMonthPicker(YearMonth from, YearMonth to, YearMonth initial, Locale locale, String monthPattern, String yearMonthPattern)__
This gives you all yearmonths between from and to (both from and to included) with the
initial value as the default selected in the locale specified. MonthNameFormat is how the
month names will be displayed in the popup. Default is "MMMM" (long format), set to "MMM" for the letter short style
or include the year with "yyyy-MMM" or whatever. The display value (when a year month is chosen) will be displayed in the
format provided with the yearMonthPattern argument.