mirror of
https://github.com/yabwon/SAS_PACKAGES.git
synced 2026-01-05 22:30:05 +00:00
The BasePlus package [ver. 1.32.0]
The BasePlus package [ver. 1.32.0] New `%monthShift()` macro added: ```sas %put %monthShift(2023,1,-3); ``` Doc. updated.
This commit is contained in:
Bart Jablonski
@@ -86,7 +86,7 @@ SHA256 digest for macroArray: F*E9C0C58FB36AC40C76A518066B8C6F9942202A9DB2C2D737
|
||||
|
||||
---
|
||||
|
||||
- **BasePlus**\[1.31.0\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
- **BasePlus**\[1.32.0\] adds a bunch of functionalities I am missing in BASE SAS, such as:
|
||||
```sas
|
||||
call arrMissToRight(myArray);
|
||||
call arrFillMiss(17, myArray);
|
||||
@@ -111,8 +111,10 @@ format x bool.;
|
||||
%put %repeatTxt(#,15,s=$) HELLO SAS! %repeatTxt(#,15,s=$);
|
||||
|
||||
%put %date() %time() %datetime();
|
||||
|
||||
%put %monthShift(2023,1,-5);
|
||||
```
|
||||
SHA256 digest for BasePlus: F*7EF23E80A2C03B29402183D97ECFF608B62BEDD9458848709B52DC362E6201B9
|
||||
SHA256 digest for BasePlus: F*81EF4FA7E1D9363A991B686F38C6569FFB22024CB9C67A9395EEF6D4257D508E
|
||||
|
||||
[Documentation for BasePlus](https://github.com/yabwon/SAS_PACKAGES/blob/main/packages/baseplus.md "Documentation for BasePlus")
|
||||
|
||||
|
||||
@@ -1,3 +1,6 @@
|
||||
/* 20231026 */
|
||||
BasePlus: F*81EF4FA7E1D9363A991B686F38C6569FFB22024CB9C67A9395EEF6D4257D508E
|
||||
|
||||
/* 20231012 */
|
||||
BasePlus: F*7EF23E80A2C03B29402183D97ECFF608B62BEDD9458848709B52DC362E6201B9
|
||||
|
||||
|
||||
@@ -64,6 +64,7 @@
|
||||
* [`%today()` macro](#today-macro)
|
||||
* [`%time()` macro](#time-macro)
|
||||
* [`%datetime()` macro](#datetime-macro)
|
||||
* [`%monthShift()` macro](#monthshift-macro)
|
||||
* [`%translate()` macro](#translate-macro)
|
||||
* [`%tranwrd()` macro](#tranwrd-macro)
|
||||
* [`%findDSwithVarVal()` macro](#finddswithvarval-macro)
|
||||
@@ -77,7 +78,7 @@
|
||||
|
||||
---
|
||||
|
||||
# The BasePlus package [ver. 1.31.0] <a name="baseplus-package"></a> ###############################################
|
||||
# The BasePlus package [ver. 1.32.0] <a name="baseplus-package"></a> ###############################################
|
||||
|
||||
The **BasePlus** package implements useful
|
||||
functions and functionalities I miss in the BASE SAS.
|
||||
@@ -85,6 +86,7 @@ functions and functionalities I miss in the BASE SAS.
|
||||
It is inspired by various people, e.g.
|
||||
- at the SAS-L discussion list
|
||||
- at the communities.sas.com (SASware Ballot Ideas)
|
||||
- at StackOverflow
|
||||
- at the Office...
|
||||
- etc.
|
||||
|
||||
@@ -100,8 +102,6 @@ Kudos to all who inspired me to generate this package:
|
||||
*Kurt Bremser*,
|
||||
*Leonid Batkhan*.
|
||||
|
||||
Recording from the SAS Explore 2022 conference: [A BasePlus Package for SAS](https://communities.sas.com/t5/SAS-Explore-Presentations/A-BasePlus-Package-for-SAS/ta-p/838246 "A BasePlus Package for SAS") (September 27th-29th, 2022).
|
||||
|
||||
---
|
||||
|
||||
### BASIC EXAMPLES AND USECASES: ####################################################
|
||||
@@ -345,6 +345,15 @@ run;
|
||||
%put %today() %date() %time() %datetime();
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**EXAMPLE 24** Months shifting:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%put
|
||||
Past: %monthShift(2023, 1, -1)
|
||||
Current: %monthShift(2023, 1 )
|
||||
Future: %monthShift(2023, 1, +1)
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
Package contains:
|
||||
@@ -413,22 +422,24 @@ Package contains:
|
||||
63. macro letters
|
||||
64. macro libpath
|
||||
65. macro minclude
|
||||
66. macro replist
|
||||
67. macro time
|
||||
68. macro today
|
||||
69. macro translate
|
||||
70. macro tranwrd
|
||||
71. macro workpath
|
||||
66. macro monthshift
|
||||
67. macro replist
|
||||
68. macro time
|
||||
69. macro today
|
||||
70. macro translate
|
||||
71. macro tranwrd
|
||||
72. macro workpath
|
||||
|
||||
|
||||
|
||||
Package contains additional content, run: %loadPackageAddCnt(BasePlus) to load it
|
||||
or look for the baseplus_AdditionalContent directory in the Packages fileref
|
||||
localization (only if additional content was deployed during the installation process).
|
||||
|
||||
* SAS package generated by generatePackage, version 20231009 *
|
||||
* SAS package generated by generatePackage, version 20231024 *
|
||||
|
||||
The SHA256 hash digest for package BasePlus:
|
||||
`F*7EF23E80A2C03B29402183D97ECFF608B62BEDD9458848709B52DC362E6201B9`
|
||||
`F*81EF4FA7E1D9363A991B686F38C6569FFB22024CB9C67A9395EEF6D4257D508E`
|
||||
|
||||
---
|
||||
# Content description ############################################################################################
|
||||
@@ -5107,6 +5118,149 @@ The basic syntax is the following, the `<...>` means optional parameters:
|
||||
|
||||
---
|
||||
|
||||
## >>> `%monthShift()` macro: <<< <a name="monthshift-macro"></a> #######################
|
||||
|
||||
The monthShift() macro is a utility macro
|
||||
which allows to shift "year-month" period by
|
||||
a given number of "periods" (months).
|
||||
|
||||
The result is in the `YYYYMM` format but can be altered.
|
||||
|
||||
See examples below for the details.
|
||||
|
||||
The `%monthShift()` macro executes like a pure macro code.
|
||||
|
||||
### SYNTAX: ###################################################################
|
||||
|
||||
The basic syntax is the following, the `<...>` means optional parameters:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%monthShift(
|
||||
< Y>
|
||||
<,M>
|
||||
<,shift>
|
||||
<,ofmt=>
|
||||
)
|
||||
~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
**Arguments description**:
|
||||
|
||||
1. `Y` - *Optional*, a year from which counting starts.
|
||||
If null the value is set to *system year*.
|
||||
|
||||
2. `M` - *Optional*, a month from which counting starts.
|
||||
If null the value is set to `1`. Can be a number
|
||||
(`1` to `12`) or a name (`June`, `OCTOBER`) or
|
||||
a three letters short (`JAN`, `apr`).
|
||||
|
||||
3. `shift` - *Optional*, number of periods to shift.
|
||||
If null the value is set to `0`.
|
||||
Positive value shifts to the "future",
|
||||
negative value shifts to the "past",
|
||||
Can be an expression (e.g. `1+2*3`, see examples).
|
||||
|
||||
* `ofmt=YYMMn6.` - *Optional*, it is a format name used to
|
||||
display the result. Default value is `YYMMn6.`
|
||||
See examples.
|
||||
|
||||
---
|
||||
|
||||
### EXAMPLES AND USECASES: ####################################################
|
||||
|
||||
**EXAMPLE 1.** Shift one up and one down:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%put
|
||||
Past: %monthShift(2023, 1, -1)
|
||||
Current: %monthShift(2023, 1 )
|
||||
Future: %monthShift(2023, 1, +1)
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
**EXAMPLE 2.** Shift by expression:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%let n = 2;
|
||||
%put
|
||||
%monthShift(2023, 1, +1 + &n.*3)
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
**EXAMPLE 3.** Shift with default values:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%put %monthShift();
|
||||
%put %monthShift(2023);
|
||||
%put %monthShift(2023,Jan);
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
**EXAMPLE 4.** Shift with months names:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%put
|
||||
%monthShift(2023,Jan,-1)
|
||||
%monthShift(2023,Feb,-2)
|
||||
%monthShift(2023,Mar,-3)
|
||||
%monthShift(2023,Apr,-4)
|
||||
%monthShift(2023,May,-5)
|
||||
%monthShift(2023,Jun,-6)
|
||||
%monthShift(2023,Jul,-7)
|
||||
%monthShift(2023,Aug,-8)
|
||||
%monthShift(2023,Sep,-9)
|
||||
%monthShift(2023,Oct,-10)
|
||||
%monthShift(2023,Nov,-11)
|
||||
%monthShift(2023,Dec,-12)
|
||||
;
|
||||
|
||||
%put
|
||||
%monthShift(2023,January,12)
|
||||
%monthShift(2023,February,11)
|
||||
%monthShift(2023,March,10)
|
||||
%monthShift(2023,April,9)
|
||||
%monthShift(2023,May,8)
|
||||
%monthShift(2023,June,7)
|
||||
%monthShift(2023,July,6)
|
||||
%monthShift(2023,August,5)
|
||||
%monthShift(2023,September,4)
|
||||
%monthShift(2023,October,3)
|
||||
%monthShift(2023,November,2)
|
||||
%monthShift(2023,December,1)
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
**EXAMPLE 5.** Play with formatting:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
%put
|
||||
%monthShift(2023, 1, +1 )
|
||||
%monthShift(2023, 1, +1, ofmt=yymm7. )
|
||||
%monthShift(2023, 1, +1, ofmt=yymmd7.)
|
||||
%monthShift(2023, 1, +1, ofmt=yymms7.)
|
||||
;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
|
||||
**EXAMPLE 6.** Read monthly data with `noDSNFERR` option:
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
|
||||
data
|
||||
A202210 A202211 A202212
|
||||
A202301 A202302 A202303
|
||||
A202304 A202305 A202306
|
||||
A202307 A202308 A202309
|
||||
;
|
||||
set sashelp.class;
|
||||
run;
|
||||
|
||||
|
||||
options noDSNFERR;
|
||||
data ALL;
|
||||
set
|
||||
A%monthShift(2023, 9, -12) - A%monthShift(2023, 9)
|
||||
;
|
||||
run;
|
||||
options DSNFERR;
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
---
|
||||
|
||||
|
||||
## >>> `%translate()` macro: <<< <a name="translate-macro"></a> #######################
|
||||
|
||||
|
||||
Binary file not shown.
Reference in New Issue
Block a user